CircleImageView

圆形图像视图

快速的圆形 ImageView，非常适合个人资料图像。这是基于 Vince Mi 的 RoundedImageView，它本身基于 Romain Guy 推荐的技术。

它使用 BitmapShader，但不：

• 创建原始位图的副本
• 使用clipPath（既不是硬件加速也不是抗锯齿）
• 使用 setXfermode 剪辑位图（这意味着在画布上绘制两次）

由于这只是一个自定义 ImageView 而不是自定义 Drawable 或两者的组合，因此它可以与所有类型的可绘制对象一起使用，即来自 Picasso 的 PicassoDrawable 或其他非标准可绘制对象（但需要一些测试）。

摇篮

 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 这样的图像加载库，您需要禁用它们的淡入淡出动画以避免图像混乱。对于 Picasso 使用noFade()选项，对于 Glide 使用dontAnimate() 。如果您想保留淡入动画，则必须将图像提取到Target中，并在接收Bitmap时自行应用自定义动画。
• 将TransitionDrawable与CircleImageView一起使用无法正常工作并导致图像混乱。

常问问题

如何将VectorDrawable与CircleImageView一起使用？

简短的回答：你不应该。将VectorDrawable与CircleImageView一起使用的效率非常低。您应该将矢量修改为圆形，并将它们与常规 ImageView 一起使用。

为什么CircleImageView不扩展AppCompatImageView ？

扩展AppCompatImageView需要添加支持库的运行时依赖项，但没有任何实际好处。

如何添加绑定到圆圈的选择器（例如波纹效果）？

目前没有对圆形绑定选择器的直接支持，但您可以按照以下步骤自行实现。

如何在图像和边框之间添加间隙？

也不直接支持添加间隙，但有一个解决方法。

变更日志

• 3.1.0
  • 将位图绘制标志与 BitmapDrawable 对齐（改进缩放）
• 3.0.2
  • 在 API 级别 <= 19 的初始化期间修复 NPE
  • 修复禁用圆形变换时提供的错误轮廓
• 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(Context context) 时视图未初始化的问题
• 1.1.1
  • 修复边框宽度设置为 0 时仍显示的问题
• 1.1.0
  • 添加对 ColorDrawables 的支持
  • 添加边框颜色和边框宽度的 getter 和 setter
• 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.