CircleImageView

Tampilan Gambar Lingkaran

ImageView melingkar cepat yang sempurna untuk gambar profil. Ini berdasarkan RoundedImageView dari Vince Mi yang didasarkan pada teknik yang direkomendasikan oleh Romain Guy.

Ia menggunakan BitmapShader dan tidak :

• membuat salinan bitmap asli
• gunakan clipPath (yang bukan akselerasi perangkat keras atau anti-alias)
• gunakan setXfermode untuk memotong bitmap (yang berarti menggambar dua kali ke kanvas)

Karena ini hanya ImageView kustom dan bukan Drawable kustom atau kombinasi keduanya, maka dapat digunakan dengan semua jenis drawable, yaitu PicassoDrawable dari Picasso atau drawable non-standar lainnya (namun memerlukan beberapa pengujian).

Gradle

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

Penggunaan

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

Keterbatasan

• ScaleType selalu CENTER_CROP dan Anda akan mendapatkan pengecualian jika mencoba mengubahnya. Ini (saat ini) dirancang karena baik-baik saja untuk gambar profil.
• Mengaktifkan adjustViewBounds tidak didukung karena memerlukan ScaleType yang tidak didukung
• Jika Anda menggunakan perpustakaan pemuatan gambar seperti Picasso atau Glide, Anda perlu menonaktifkan animasi pudarnya untuk menghindari gambar yang kacau. Untuk Picasso gunakan opsi noFade() , untuk Glide gunakan dontAnimate() . Jika Anda ingin mempertahankan animasi fadeIn, Anda harus mengambil gambar ke dalam Target dan menerapkan sendiri animasi khusus saat menerima Bitmap .
• Menggunakan TransitionDrawable dengan CircleImageView tidak berfungsi dengan baik dan menyebabkan gambar kacau.

Pertanyaan Umum

Bagaimana saya bisa menggunakan VectorDrawable dengan CircleImageView ?

Jawaban singkatnya: sebaiknya jangan. Menggunakan VectorDrawable dengan CircleImageView sangat tidak efisien. Anda harus memodifikasi vektor Anda menjadi bentuk lingkaran dan menggunakannya dengan ImageView biasa.

Mengapa CircleImageView tidak memperluas AppCompatImageView ?

Memperluas AppCompatImageView memerlukan penambahan ketergantungan waktu proses untuk pustaka dukungan tanpa manfaat nyata.

Bagaimana cara menambahkan pemilih (misalnya efek riak) yang terikat pada lingkaran?

Saat ini tidak ada dukungan langsung untuk pemilih terikat lingkaran tetapi Anda dapat mengikuti langkah-langkah berikut untuk menerapkannya sendiri.

Bagaimana cara menambahkan celah antara gambar dan batas?

Menambahkan celah juga tidak didukung secara langsung tetapi ada solusinya.

log perubahan

• 3.1.0
  • Sejajarkan tanda cat bitmap dengan BitmapDrawable (meningkatkan penskalaan)
• 3.0.2
  • Perbaiki NPE selama inisialisasi pada API level <= 19
  • Perbaiki garis besar yang salah jika transformasi melingkar dinonaktifkan
• 3.0.1
  • Perbaiki acara sentuh tidak diaktifkan jika tampilan kosong
  • Perbaiki area yang dapat disentuh terbatas pada lingkaran meskipun transformasi dinonaktifkan
• 3.0.0
  • Batasi penanganan acara sentuh pada area lingkaran
  • Bermigrasi ke AndroidX
  • Hapus properti dan metode yang tidak digunakan lagi
• 2.2.0
  • Tambahkan dukungan untuk ketinggian
  • Tambahkan atribut warna latar belakang lingkaran untuk menggantikan warna isian
• 2.1.0
  • Tambahkan dukungan untuk padding
  • Tambahkan opsi untuk menonaktifkan transformasi melingkar
  • Memperbaiki celah garis rambut yang dibuat antara gambar dan batas dalam kondisi tertentu
  • Perbaiki NPE saat menggunakan atribut tint (yang tidak didukung)
  • Tidak lagi menggunakan warna isian karena tampaknya menyebabkan kebingungan
• 2.0.0
  • BREAKING: Atribut xml khusus kini diawali dengan "civ_"
  • Penanganan yang baik terhadap drawable yang tidak kompatibel
  • Tambahkan dukungan untuk warna isian yang ditampilkan di belakang gambar dengan area transparan
  • Perbaiki masalah penghitungan dimensi pada gambar kecil
  • Perbaiki bitmap yang tidak dihapus saat disetel ke nol
• 1.3.0
  • Tambahkan setBorderColorResource(int resId)
  • Tambahkan anotasi jenis sumber daya
  • Tambahkan atribut border_overlay untuk memungkinkan menggambar batas di atas gambar dasar
• 1.2.2
  • Tambahkan dukungan ColorFilter
• 1.2.1
  • Perbaiki ColorDrawables yang tidak ditampilkan dengan benar di Lollipop
• 1.2.0
  • Tambahkan dukungan untuk setImageURI(Uri uri)
  • Perbaiki tampilan yang tidak diinisialisasi saat menggunakan CircleImageView (Konteks konteks)
• 1.1.1
  • Perbaiki batas yang ditampilkan meskipun lebar batas diatur ke 0
• 1.1.0
  • Tambahkan dukungan untuk ColorDrawables
  • Tambahkan pengambil dan penyetel untuk warna batas dan lebar batas
• 1.0.1
  • Mencegah crash karena OutOfMemoryError
• 1.0.0
  • Rilis awal

Lisensi

 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.