CircleImageView

CercleImageView

Un ImageView circulaire rapide, parfait pour les images de profil. Celui-ci est basé sur RoundedImageView de Vince Mi qui lui-même s'appuie sur les techniques préconisées par Romain Guy.

Il utilise un BitmapShader et ne :

• créer une copie du bitmap original
• utiliser un clipPath (qui n'est ni accéléré matériellement ni anticrénelé)
• utilisez setXfermode pour découper le bitmap (ce qui signifie dessiner deux fois sur le canevas)

Comme il s'agit simplement d'un ImageView personnalisé et non d'un Drawable personnalisé ou d'une combinaison des deux, il peut être utilisé avec toutes sortes de drawables, c'est-à-dire un PicassoDrawable de Picasso ou d'autres drawables non standard (nécessite cependant quelques tests).

Graduation

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

Usage

< 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 " />

Limites

• Le ScaleType est toujours CENTER_CROP et vous obtiendrez une exception si vous essayez de le modifier. C'est (actuellement) par conception car c'est parfaitement bien pour les images de profil.
• L'activation adjustViewBounds n'est pas prise en charge car elle nécessite un ScaleType non pris en charge
• Si vous utilisez une bibliothèque de chargement d'images comme Picasso ou Glide, vous devez désactiver leurs animations de fondu pour éviter les images gâchées. Pour Picasso, utilisez l'option noFade() , pour Glide, utilisez dontAnimate() . Si vous souhaitez conserver l'animation fadeIn, vous devez récupérer l'image dans une Target et appliquer vous-même une animation personnalisée lors de la réception du Bitmap .
• L'utilisation d'un TransitionDrawable avec CircleImageView ne fonctionne pas correctement et conduit à des images gâchées.

FAQ

Comment puis-je utiliser un VectorDrawable avec CircleImageView ?

Réponse courte : vous ne devriez pas. Utiliser un VectorDrawable avec CircleImageView est très inefficace. Vous devez modifier vos vecteurs pour qu'ils aient une forme circulaire et les utiliser à la place avec un ImageView normal.

Pourquoi CircleImageView n'étend-il pas AppCompatImageView ?

L'extension AppCompatImageView nécessiterait l'ajout d'une dépendance d'exécution pour la bibliothèque de support sans aucun avantage réel.

Comment puis-je ajouter un sélecteur (par exemple un effet d'entraînement) lié à un cercle ?

Il n'existe actuellement aucune prise en charge directe pour un sélecteur lié à un cercle, mais vous pouvez suivre ces étapes pour l'implémenter vous-même.

Comment puis-je ajouter un espace entre l'image et la bordure ?

L'ajout d'un espace n'est pas non plus directement pris en charge, mais il existe une solution de contournement.

Journal des modifications

• 3.1.0
  • Alignez les indicateurs de peinture bitmap avec BitmapDrawable (améliore la mise à l'échelle)
• 3.0.2
  • Correction de NPE lors de l'initialisation au niveau API <= 19
  • Correction d'un contour incorrect fourni si la transformation circulaire est désactivée
• 3.0.1
  • Correction de l'événement tactile non déclenché si la vue est vide
  • Correction de la zone tactile limitée à un cercle même si la transformation est désactivée
• 3.0.0
  • Limiter la gestion des événements tactiles à la zone du cercle
  • Migrer vers AndroidX
  • Supprimer les propriétés et méthodes obsolètes
• 2.2.0
  • Ajouter la prise en charge de l'élévation
  • Ajouter un attribut de couleur d'arrière-plan du cercle pour remplacer la couleur de remplissage
• 2.1.0
  • Ajouter la prise en charge du remplissage
  • Ajouter une option pour désactiver la transformation circulaire
  • Correction de l'écart entre la racine des cheveux et la bordure sous certaines conditions.
  • Correction de NPE lors de l'utilisation de l'attribut tint (qui n'est pas pris en charge)
  • Déprécier la couleur de remplissage car elle semble causer une certaine confusion
• 2.0.0
  • RUPTURE : Les attributs XML personnalisés sont désormais préfixés par "civ_".
  • Gestion gracieuse des drawables incompatibles
  • Ajout de la prise en charge d'une couleur de remplissage affichée derrière les images avec des zones transparentes
  • Résoudre les problèmes de calcul des dimensions avec les petites images
  • Correction du bitmap qui n'était pas effacé lorsqu'il était défini sur null
• 1.3.0
  • Ajouter setBorderColorResource (int resId)
  • Ajouter des annotations de type de ressource
  • Ajoutez l'attribut border_overlay pour permettre de dessiner une bordure au-dessus de l'image de base
• 1.2.2
  • Ajouter la prise en charge de ColorFilter
• 1.2.1
  • Correction de ColorDrawables qui n'est pas rendu correctement sur Lollipop
• 1.2.0
  • Ajouter la prise en charge de setImageURI (Uri uri)
  • Correction de la vue qui n'était pas initialisée lors de l'utilisation de CircleImageView (contexte contextuel)
• 1.1.1
  • Correction de la bordure affichée bien que la largeur de la bordure soit définie sur 0
• 1.1.0
  • Ajouter la prise en charge de ColorDrawables
  • Ajoutez des getters et des setters pour la couleur et la largeur de la bordure
• 1.0.1
  • Empêcher un crash dû à OutOfMemoryError
• 1.0.0
  • Version initiale

Licence

 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.