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.