CircleImageView

CírculoImageView

Um ImageView circular rápido, perfeito para imagens de perfil. Isso é baseado no RoundedImageView de Vince Mi, que é baseado em técnicas recomendadas por Romain Guy.

Ele usa um BitmapShader e não :

• crie uma cópia do bitmap original
• use um clipPath (que não é acelerado por hardware nem suavizado)
• use setXfermode para recortar o bitmap (o que significa desenhar duas vezes na tela)

Como este é apenas um ImageView personalizado e não um Drawable personalizado ou uma combinação de ambos, ele pode ser usado com todos os tipos de drawables, ou seja, um PicassoDrawable de Picasso ou outros drawables não padrão (embora precise de alguns testes).

Gradle

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

Uso

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

Limitações

• O ScaleType é sempre CENTER_CROP e você receberá uma exceção se tentar alterá-lo. Isso (atualmente) ocorre intencionalmente, pois é perfeitamente adequado para imagens de perfil.
• A ativação de adjustViewBounds não é suportada, pois requer um ScaleType não suportado
• Se você usar uma biblioteca de carregamento de imagens como Picasso ou Glide, será necessário desativar suas animações de fade para evitar imagens confusas. Para Picasso use a opção noFade() , para Glide use dontAnimate() . Se quiser manter a animação fadeIn, você deve buscar a imagem em um Target e aplicar você mesmo uma animação personalizada ao receber o Bitmap .
• Usar um TransitionDrawable com CircleImageView não funciona corretamente e leva a imagens confusas.

Perguntas frequentes

Como posso usar um VectorDrawable com CircleImageView ?

Resposta curta: você não deveria. Usar um VectorDrawable com CircleImageView é muito ineficiente. Você deve modificar seus vetores para que tenham uma forma circular e usá-los com um ImageView normal.

Por que CircleImageView não estende AppCompatImageView ?

Estender AppCompatImageView exigiria a adição de uma dependência de tempo de execução para a biblioteca de suporte sem nenhum benefício real.

Como posso adicionar um seletor (por exemplo, efeito cascata) vinculado a um círculo?

Atualmente não há suporte direto para um seletor circular, mas você pode seguir estas etapas para implementá-lo sozinho.

Como posso adicionar um espaço entre a imagem e a borda?

Adicionar uma lacuna também não é suportado diretamente, mas há uma solução alternativa.

Registro de alterações

• 3.1.0
  • Alinhe sinalizadores de pintura de bitmap com BitmapDrawable (melhora o dimensionamento)
• 3.0.2
  • Correção do NPE durante a inicialização no nível da API <= 19
  • Corrigido contorno incorreto fornecido se a transformação circular estiver desativada
• 3.0.1
  • Corrigido evento de toque não acionado se a visualização estiver vazia
  • Corrigida a área tocável limitada a um círculo mesmo se a transformação estiver desativada
• 3.0.0
  • Limitar o tratamento de eventos de toque à área do círculo
  • Migrar para AndroidX
  • Remover propriedades e métodos obsoletos
• 2.2.0
  • Adicione suporte para elevação
  • Adicionar atributo de cor de fundo do círculo para substituir a cor de preenchimento
• 2.1.0
  • Adicionar suporte para preenchimento
  • Adicionar opção para desativar a transformação circular
  • Corrija a lacuna desenhada entre a imagem e a borda sob algumas condições
  • Corrija o NPE ao usar o atributo tint (que não é compatível)
  • Descontinuar a cor de preenchimento, pois parece causar alguma confusão
• 2.0.0
  • QUEBRANDO: atributos XML personalizados agora têm o prefixo "civ_"
  • Manuseio elegante de drawables incompatíveis
  • Adicionado suporte para uma cor de preenchimento mostrada atrás de imagens com áreas transparentes
  • Corrigir problemas de cálculo de dimensões com imagens pequenas
  • Corrigido o bitmap que não era limpo quando definido como nulo
• 1.3.0
  • Adicionar setBorderColorResource(int resId)
  • Adicionar anotações de tipo de recurso
  • Adicione o atributo border_overlay para permitir desenhar uma borda no topo da imagem base
• 1.2.2
  • Adicionar suporte ColorFilter
• 1.2.1
  • Corrigir ColorDrawables que não está sendo renderizado corretamente no Lollipop
• 1.2.0
  • Adicionar suporte para setImageURI(Uri uri)
  • Corrigida a visualização que não era inicializada ao usar CircleImageView (contexto de contexto)
• 1.1.1
  • Corrigida a exibição da borda embora a largura da borda esteja definida como 0
• 1.1.0
  • Adicionar suporte para ColorDrawables
  • Adicione getters e setters para cor e largura da borda
• 1.0.1
  • Evitar travamento devido a OutOfMemoryError
• 1.0.0
  • Lançamento inicial

Licença

 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.