CircleImageView

КругизображениеView

Быстрый круговой ImageView, идеально подходящий для изображений профиля. Он основан на RoundedImageView от Винса Ми, который сам по себе основан на методах, рекомендованных Роменом Гаем.

Он использует BitmapShader и не :

• создать копию исходного растрового изображения
• используйте clipPath (который не имеет ни аппаратного ускорения, ни сглаживания)
• используйте setXfermode для обрезки растрового изображения (что означает двойное рисование на холсте)

Поскольку это всего лишь пользовательский ImageView, а не пользовательский Drawable или комбинация того и другого, его можно использовать со всеми видами рисунков, например PicassoDrawable от Picasso или другими нестандартными рисунками (хотя требует некоторого тестирования).

Градл

 dependencies {
    ...
    implementation 'de.hdodenhof:circleimageview:3.1.0'
}

Использование

< de .hdodenhof.circleimageview.CircleImageView
    xmlns : app = " http://schemas.android.com/apk/res-auto "
    android : id = " @+id/profile_image "
    android : layout_width = " 96dp "
    android : layout_height = " 96dp "
    android : src = " @drawable/profile "
    app : civ_border_width = " 2dp "
    app : civ_border_color = " #FF000000 " />

Ограничения

• ScaleType всегда имеет значение CENTER_CROP, и если вы попытаетесь его изменить, вы получите исключение. Это (на данный момент) задумано, поскольку оно идеально подходит для изображений профиля.
• Включение adjustViewBounds не поддерживается, поскольку для этого требуется неподдерживаемый ScaleType.
• Если вы используете библиотеку загрузки изображений, такую ​​​​как Picasso или Glide, вам необходимо отключить анимацию затухания, чтобы избежать испорченных изображений. Для Пикассо используйте опцию noFade() , для Glide используйте dontAnimate() . Если вы хотите сохранить анимацию FadeIn, вам необходимо загрузить изображение в Target и самостоятельно применить пользовательскую анимацию при получении Bitmap .
• Использование TransitionDrawable с CircleImageView не работает должным образом и приводит к искажению изображений.

Часто задаваемые вопросы

Как я могу использовать VectorDrawable с CircleImageView ?

Короткий ответ: не следует. Использование VectorDrawable с CircleImageView очень неэффективно. Вам следует изменить векторы, чтобы они имели круглую форму, и вместо этого использовать их с обычным ImageView.

Почему CircleImageView не расширяет AppCompatImageView ?

Расширение AppCompatImageView потребует добавления зависимости времени выполнения для библиотеки поддержки без какой-либо реальной выгоды.

Как добавить селектор (например, эффект пульсации), привязанный к кругу?

В настоящее время нет прямой поддержки селектора, ограниченного кругом, но вы можете выполнить следующие шаги, чтобы реализовать его самостоятельно.

Как добавить разрыв между изображением и границей?

Добавление пробела также не поддерживается напрямую, но есть обходной путь.

Журнал изменений

• 3.1.0
  • Выровняйте флаги рисования растровых изображений с помощью BitmapDrawable (улучшает масштабирование).
• 3.0.2
  • Исправлен NPE во время инициализации на уровне API <= 19.
  • Исправлен неверный контур, если отключено круговое преобразование.
• 3.0.1
  • Исправлено событие касания, которое не запускалось, если представление пусто.
  • Исправить осязаемую область, ограниченную кругом, даже если трансформация отключена.
• 3.0.0
  • Ограничьте обработку событий касания областью круга
  • Перейти на AndroidX
  • Удалить устаревшие свойства и методы
• 2.2.0
  • Добавить поддержку высоты
  • Добавьте атрибут цвета фона круга, чтобы заменить цвет заливки
• 2.1.0
  • Добавить поддержку отступов
  • Добавить возможность отключить круговое преобразование
  • Исправить тонкий зазор между изображением и границей при некоторых условиях.
  • Исправлен NPE при использовании атрибута оттенка (который не поддерживается).
  • Устаревший цвет заливки, поскольку он вызывает некоторую путаницу.
• 2.0.0
  • СРОЧНО: Пользовательские атрибуты XML теперь имеют префикс «civ_».
  • Изящная обработка несовместимых чертежей
  • Добавить поддержку цвета заливки, отображаемого за изображениями с прозрачными областями.
  • Исправление проблем с расчетом размеров для маленьких изображений.
  • Исправлено растровое изображение, которое не очищалось, если установлено значение null.
• 1.3.0
  • Добавить setBorderColorResource (int resId)
  • Добавить аннотации типов ресурсов
  • Добавьте атрибут border_overlay, чтобы разрешить рисование границы поверх базового изображения.
• 1.2.2
  • Добавить поддержку ColorFilter
• 1.2.1
  • Исправлена ​​ошибка, из-за которой ColorDrawables не отображалась должным образом на Lollipop.
• 1.2.0
  • Добавить поддержку setImageURI(Uri uri).
  • Исправлена ​​ошибка, из-за которой представление не инициализировалось при использовании CircleImageView (контекст контекста).
• 1.1.1
  • Исправлено отображение границы, хотя ширина границы установлена ​​на 0.
• 1.1.0
  • Добавить поддержку ColorDrawables.
  • Добавьте геттеры и сеттеры для цвета и ширины границы.
• 1.0.1
  • Предотвратить сбой из-за OutOfMemoryError
• 1.0.0
  • Первоначальный выпуск

Лицензия

 Copyright 2014 - 2020 Henning Dodenhof

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.