CircleImageView

CircleImageView

عرض ImageView دائري سريع مثالي لصور الملف الشخصي. يعتمد هذا على RoundedImageView من Vince Mi والذي يعتمد في حد ذاته على التقنيات التي أوصى بها Romain Guy.

يستخدم BitmapShader ولا :

• إنشاء نسخة من الصورة النقطية الأصلية
• استخدام clipPath (وهو ليس مُسرّعًا للأجهزة ولا مصقولًا)
• استخدم setXfermode لقص الصورة النقطية (مما يعني الرسم مرتين على اللوحة القماشية)

نظرًا لأن هذا مجرد ImageView مخصص وليس Drawable مخصصًا أو مزيجًا من الاثنين معًا، فيمكن استخدامه مع جميع أنواع الرسوميات، على سبيل المثال PicassoDrawable من Picasso أو غيرها من الرسوميات غير القياسية (رغم أنها تحتاج إلى بعض الاختبارات).

جرادل

 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
  • كسر: سمات XML المخصصة أصبحت الآن مسبوقة بـ "civ_"
  • معالجة رشيقة للرسومات غير المتوافقة
  • أضف دعمًا للون التعبئة الموضح خلف الصور ذات المساحات الشفافة
  • إصلاح مشاكل حساب البعد مع الصور الصغيرة
  • إصلاح عدم مسح الصورة النقطية عند التعيين على قيمة خالية
• 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
  • إضافة حروف ومحددات للون الحدود وعرض الحدود
• 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.