CircleImageView

CircleImageView

ImageView แบบวงกลมที่รวดเร็วเหมาะสำหรับภาพโปรไฟล์ สิ่งนี้อิงจาก RoundedImageView จาก Vince Mi ซึ่งอิงตามเทคนิคที่แนะนำโดย Romain Guy

มันใช้ BitmapShader และ ไม่ :

• สร้างสำเนาของบิตแมปต้นฉบับ
• ใช้ clipPath (ซึ่งไม่ใช่การเร่งความเร็วด้วยฮาร์ดแวร์หรือการลดนามแฝง)
• ใช้ setXfermode เพื่อตัดบิตแมป (ซึ่งหมายถึงการวาดสองครั้งบนผืนผ้าใบ)

เนื่องจากนี่เป็นเพียง ImageView แบบกำหนดเอง และไม่ใช่ Drawable แบบกำหนดเองหรือทั้งสองอย่างรวมกัน จึงสามารถใช้กับ Drawable ได้ทุกประเภท เช่น PicassoDrawable จาก Picasso หรือ Drawable ที่ไม่ได้มาตรฐานอื่นๆ (ต้องมีการทดสอบบ้าง)

เกรเดิล

 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() หากคุณต้องการเก็บแอนิเมชั่น fadeIn ไว้ คุณต้องดึงรูปภาพมาไว้ใน Target และใช้แอนิเมชั่นแบบกำหนดเองด้วยตนเองเมื่อได้รับ Bitmap
• การใช้ TransitionDrawable กับ CircleImageView ทำงานไม่ถูกต้องและทำให้ภาพที่เลอะเทอะ

คำถามที่พบบ่อย

ฉันจะใช้ VectorDrawable กับ CircleImageView ได้อย่างไร

คำตอบสั้น ๆ : คุณไม่ควร การใช้ VectorDrawable กับ CircleImageView นั้นไม่มีประสิทธิภาพมากนัก คุณควรแก้ไขเวกเตอร์ของคุณให้เป็นรูปวงกลมและใช้กับ ImageView ปกติแทน

เหตุใด CircleImageView จึงไม่ขยาย AppCompatImageView

การขยาย AppCompatImageView จะต้องเพิ่มการพึ่งพารันไทม์สำหรับไลบรารีการสนับสนุนโดยไม่มีประโยชน์ที่แท้จริง

ฉันจะเพิ่มตัวเลือก (เช่น เอฟเฟกต์ระลอกคลื่น) ที่ผูกไว้กับวงกลมได้อย่างไร

ขณะนี้ยังไม่มีการสนับสนุนโดยตรงสำหรับตัวเลือกที่ถูกผูกไว้แบบวงกลม แต่คุณสามารถทำตามขั้นตอนเหล่านี้เพื่อนำไปใช้ด้วยตนเอง

ฉันจะเพิ่มช่องว่างระหว่างรูปภาพและเส้นขอบได้อย่างไร

การเพิ่มช่องว่างยังไม่ได้รับการสนับสนุนโดยตรงแต่มีวิธีแก้ไขชั่วคราว

บันทึกการเปลี่ยนแปลง

• 3.1.0
  • จัดตำแหน่งธงสีบิตแมปด้วย BitmapDrawable (ปรับปรุงขนาด)
• 3.0.2
  • แก้ไข NPE ระหว่างการเริ่มต้นในระดับ API <= 19
  • แก้ไขโครงร่างที่ไม่ถูกต้องหากปิดใช้งานการแปลงแบบวงกลม
• 3.0.1
  • แก้ไขเหตุการณ์การสัมผัสที่ไม่ทำงานหากมุมมองว่างเปล่า
  • แก้ไขพื้นที่สัมผัสที่จำกัดไว้ที่วงกลม แม้ว่าการแปลงจะถูกปิดใช้งานก็ตาม
• 3.0.0
  • จำกัดการจัดการกิจกรรมการสัมผัสให้อยู่ในพื้นที่วงกลม
  • โยกย้ายไปยัง AndroidX
  • ลบคุณสมบัติและวิธีการที่เลิกใช้แล้ว
• 2.2.0
  • เพิ่มการสนับสนุนสำหรับการยกระดับ
  • เพิ่มแอตทริบิวต์สีพื้นหลังวงกลมเพื่อแทนที่สีเติม
• 2.1.0
  • เพิ่มการรองรับการเติม
  • เพิ่มตัวเลือกเพื่อปิดใช้งานการแปลงแบบวงกลม
  • แก้ไขช่องว่างของเส้นผมที่ถูกวาดระหว่างรูปภาพและเส้นขอบภายใต้เงื่อนไขบางประการ
  • แก้ไข NPE เมื่อใช้แอตทริบิวต์สี (ซึ่งไม่รองรับ)
  • เลิกใช้สีเติมเนื่องจากดูเหมือนว่าจะทำให้เกิดความสับสนบ้าง
• 2.0.0
  • BREAKING: ขณะนี้แอตทริบิวต์ xml ที่กำหนดเองนำหน้าด้วย "civ_"
  • การจัดการ Drawables ที่เข้ากันไม่ได้อย่างสง่างาม
  • เพิ่มการรองรับสีเติมที่แสดงอยู่ด้านหลังรูปภาพที่มีพื้นที่โปร่งใส
  • แก้ไขปัญหาการคำนวณขนาดรูปภาพขนาดเล็ก
  • แก้ไขบิตแมปไม่ถูกล้างเมื่อตั้งค่าเป็นโมฆะ
• 1.3.0
  • เพิ่ม setBorderColorResource(int resId)
  • เพิ่มคำอธิบายประกอบประเภททรัพยากร
  • เพิ่มแอตทริบิวต์ border_overlay เพื่ออนุญาตให้วาดเส้นขอบที่ด้านบนของภาพฐาน
• 1.2.2
  • เพิ่มการสนับสนุน ColorFilter
• 1.2.1
  • แก้ไข ColorDrawables ที่แสดงผลไม่ถูกต้องบน Lollipop
• 1.2.0
  • เพิ่มการรองรับ setImageURI (Uri uri)
  • แก้ไขมุมมองที่ไม่ได้เริ่มต้นเมื่อใช้ CircleImageView (บริบทบริบท)
• 1.1.1
  • แก้ไขเส้นขอบที่แสดงแม้ว่าความกว้างของเส้นขอบจะถูกตั้งค่าเป็น 0
• 1.1.0
  • เพิ่มการสนับสนุนสำหรับ ColorDrawables
  • เพิ่ม getters และ setters สำหรับสีเส้นขอบและความกว้างของเส้นขอบ
• 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.