CircleImageView

サークルイメージビュー

プロフィール画像に最適な高速循環型 ImageView。これは、Vince Mi の RoundedImageView をベースにしており、Romain Guy が推奨するテクニックに基づいています。

BitmapShader を使用しますが、次のことは行いません。

• 元のビットマップのコピーを作成する
• ClipPath を使用します (ハードウェア アクセラレーションもアンチエイリアスも行われていません)
• setXfermode を使用してビットマップをクリップします (つまり、キャンバスに 2 回描画します)。

これは単なるカスタム 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 であり、これを変更しようとすると例外が発生します。これは（現時点では）プロフィール画像にはまったく問題ないため、仕様になっています。
• サポートされていない ScaleType が必要なため、 adjustViewBoundsの有効化はサポートされていません。
• Picasso や Glide などの画像読み込みライブラリを使用する場合は、画像の乱れを避けるためにフェード アニメーションを無効にする必要があります。 Picasso の場合はnoFade()オプションを使用し、Glide の場合はdontAnimate()オプションを使用します。 fadeIn アニメーションを維持したい場合は、 Bitmap受信するときに画像をTargetにフェッチし、カスタム アニメーションを自分で適用する必要があります。
• CircleImageViewでTransitionDrawable使用すると、正しく動作せず、画像が乱れます。

よくある質問

CircleImageViewでVectorDrawable使用するにはどうすればよいですか?

短い答え: すべきではありません。 CircleImageViewでVectorDrawable使用するのは非常に非効率です。ベクトルを円形になるように変更し、代わりに通常の 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
  • カラーフィルターのサポートを追加
• 1.2.1
  • Lollipop で ColorDrawable が正しくレンダリングされない問題を修正
• 1.2.0
  • setImageURI(Uri uri) のサポートを追加
  • CircleImageView(Context context) の使用時にビューが初期化されない問題を修正
• 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.