AvatarImageView

• English

前言：

在做电话本或者其他应用时，显示联系人头像的策略一般是这样的：先判断是否有头像图片，如果有，则直接显示图片；如果没有，则显示联系人的名字的第一个字，将这个文字作为头像，并添加背景颜色。如果设置的文字的长度大于1，则具有clip效果，即超出圆形的部分将被clip掉。

截图：

添加至工程

compile 'cn.carbs.android:AvatarImageView:1.0.4'

主要功能：

1. 显示圆形图像；
2. 显示圆形文字；
3. 文字大小与圆形半径的比例可以调整；
4. 可以添加圆形边框；
5. 图片、文字的显示始终是居中的；其中图片的居中规则是：如果图片宽大于高，那么截取以高为正方形的中间部分。如果图片高大于宽，那么截取以宽为正方形的中间部分；
6. 由于是继承于ImageView，且在onDraw()时去掉了super.onDraw()，并覆写了设置drawable的函数，因此可以直接将此view赋值给类似Glide等第三方的库，使其直接加载图片，且图片为圆形（不需要做调整）;
7. 支持padding；
8. 多个文字显示具有clip效果
9. 可以自定义clip放大比例，使用maskratio来调节文字放大的比例

版本更新：

1.0.4

1. 去掉rx库

1.0.3

1. 添加显示圆角矩形的SquareAvatarImageView，可以设置圆角的半径

1.0.2

1. 添加多个文字的clip效果

注意事项：

暂时不支持wrap_content模式

圆形图像显示原理：

使用shader + matrix的方式显示圆形图片，其中圆形是有shader产生的，而居中的调整方式是由matrix设置的。

使用方法：

(1)设置图片或者文字的方法：

AvatarImageView aiv = (AvatarImageView) this.findViewById(R.id.aiv);
//设置图像：
aiv.setImageResource(R.drawable.id_014);
//或者：
aiv.setDrawable(drawable);
//或者：
aiv.setBitmap(bitmap);
//或者：
aiv.setImageDrawable(drawable);
//设置文字：
aiv.setTextAndColor("安", AvatarImageView.COLORS[0]);//直接设置颜色，如果设置的文字为多个字符，则会具有clip效果，单个字符没有clip效果
//或者：
aiv.setTextAndColorSeed("安","安卓");//“安卓”字样作为产生backgroundcolor的seed

(2)与Glide的结合：

Glide
    .with(activity)
    .load(picurl)
    .centerCrop()
    .crossFade()
    .into(aiv);

添加至工程

1.添加依赖

compile 'cn.carbs.android:AvatarImageView:1.0.3'

2.layout文件中添加此view

<cn.carbs.android.avatarimageview.library.AvatarImageView
            android:id="@+id/item_avatar"
            android:layout_width="60dp"
            android:layout_height="60dp"
            android:padding="5dp"
            app:aiv_BoarderWidth="2dp"//边框宽度
            app:aiv_ShowBoarder="false"//是否显示边框
            app:aiv_TextSizeRatio="0.4"/>//文字大小与原型直径大小的比例

感谢

CircleImageView