如何使用Android圆角头像工具类

public class CircleImageView extends ImageView {
 // 缩放类型
 private static final ScaleType SCALE_TYPE = ScaleType.CENTER_CROP;
 private static final Bitmap.Config BITMAP_CONFIG = Bitmap.Config.ARGB_8888;
 private static final int COLORDRAWABLE_DIMENSION = 2;
 // 默认边界宽度
 private static final int DEFAULT_BORDER_WIDTH = 0;
 // 默认边界颜色
 private static final int DEFAULT_BORDER_COLOR = Color.BLACK;
 private static final boolean DEFAULT_BORDER_OVERLAY = false;
 
 private final RectF mDrawableRect = new RectF();
 private final RectF mBorderRect = new RectF();
 
 private final Matrix mShaderMatrix = new Matrix();
 // 这个画笔最重要的是关联了mBitmapShader
 // 使canvas在执行的时候可以切割原图片(mBitmapShader是关联了原图的bitmap的)
 private final Paint mBitmapPaint = new Paint();
 // 这个描边，则与本身的原图bitmap没有任何关联，
 private final Paint mBorderPaint = new Paint();
 // 这里定义了 圆形边缘的默认宽度和颜色
 private int mBorderColor = DEFAULT_BORDER_COLOR;
 private int mBorderWidth = DEFAULT_BORDER_WIDTH;
 
 private Bitmap mBitmap;
 private BitmapShader mBitmapShader; // 位图渲染
 private int mBitmapWidth; // 位图宽度
 private int mBitmapHeight; // 位图高度
 
 private float mDrawableRadius;// 图片半径
 private float mBorderRadius;// 带边框的的图片半径
 
 private ColorFilter mColorFilter;
 // 初始false
 private boolean mReady;
 private boolean mSetupPending;
 private boolean mBorderOverlay;
 
 // 构造函数
 public CircleImageView(Context context) {
  super(context);
  init();
 }
 
 // 构造函数
 public CircleImageView(Context context, AttributeSet attrs) {
  this(context, attrs, 0);
 }
 
 /**
  * 构造函数
  */
 public CircleImageView(Context context, AttributeSet attrs, int defStyle) {
  super(context, attrs, defStyle);
  // 通过obtainStyledAttributes 获得一组值赋给 TypedArray（数组） ,
  // 这一组值来自于res/values/attrs.xml中的name="CircleImageView"的declare-styleable中。
  TypedArray a = context.obtainStyledAttributes(attrs,
    R.styleable.CircleImageView, defStyle, 0);
  // 通过TypedArray提供的一系列方法getXXXX取得我们在xml里定义的参数值；
  // 获取边界的宽度
  mBorderWidth = a.getDimensionPixelSize(
    R.styleable.CircleImageView_border_size, DEFAULT_BORDER_WIDTH);
  // 获取边界的颜色
  mBorderColor = a.getColor(R.styleable.CircleImageView_border_color,
    DEFAULT_BORDER_COLOR);
  // mBorderOverlay =
  // a.getBoolean(R.styleable.CircleImageView_border_overlay,
  // DEFAULT_BORDER_OVERLAY);
  // 调用 recycle() 回收TypedArray,以便后面重用
  a.recycle();
  init();
 }
 
 /**
  * 作用就是保证第一次执行setup函数里下面代码要在构造函数执行完毕时调用
  */
 private void init() {
  // 在这里ScaleType被强制设定为CENTER_CROP，就是将图片水平垂直居中，进行缩放。
  super.setScaleType(SCALE_TYPE);
  mReady = true;
 
  if (mSetupPending) {
   setup();
   mSetupPending = false;
  }
 }
 
 @Override
 public ScaleType getScaleType() {
  return SCALE_TYPE;
 }
 
 /**
  * 这里明确指出 此种imageview 只支持CENTER_CROP 这一种属性
  *
  * @param scaleType
  */
 @Override
 public void setScaleType(ScaleType scaleType) {
  if (scaleType != SCALE_TYPE) {
   throw new IllegalArgumentException(String.format(
     "ScaleType %s not supported.", scaleType));
  }
 }
 
 @Override
 public void setAdjustViewBounds(boolean adjustViewBounds) {
  if (adjustViewBounds) {
   throw new IllegalArgumentException(
     "adjustViewBounds not supported.");
  }
 }
 
 @Override
 protected void onDraw(Canvas canvas) {
  // 如果图片不存在就不画
  if (getDrawable() == null) {
   return;
  }
  // 绘制内圆形 图片 画笔为mBitmapPaint
  canvas.drawCircle(getWidth() / 2, getHeight() / 2, mDrawableRadius,
    mBitmapPaint);
  // 如果圆形边缘的宽度不为0 我们还要绘制带边界的外圆形 边界画笔为mBorderPaint
  if (mBorderWidth != 0) {
   canvas.drawCircle(getWidth() / 2, getHeight() / 2, mBorderRadius,
     mBorderPaint);
  }
 }
 
 @Override
 protected void onSizeChanged(int w, int h, int oldw, int oldh) {
  super.onSizeChanged(w, h, oldw, oldh);
  setup();
 }
 
 public int getBorderColor() {
  return mBorderColor;
 }
 
 public void setBorderColor(int borderColor) {
  if (borderColor == mBorderColor) {
   return;
  }
 
  mBorderColor = borderColor;
  mBorderPaint.setColor(mBorderColor);
  invalidate();
 }
 
 public void setBorderColorResource(@ColorRes int borderColorRes) {
  setBorderColor(getContext().getResources().getColor(borderColorRes));
 }
 
 public int getBorderWidth() {
  return mBorderWidth;
 }
 
 public void setBorderWidth(int borderWidth) {
  if (borderWidth == mBorderWidth) {
   return;
  }
 
  mBorderWidth = borderWidth;
  setup();
 }
 
 public boolean isBorderOverlay() {
  return mBorderOverlay;
 }
 
 public void setBorderOverlay(boolean borderOverlay) {
  if (borderOverlay == mBorderOverlay) {
   return;
  }
 
  mBorderOverlay = borderOverlay;
  setup();
 }
 
 /**
  * 以下四个函数都是 复写ImageView的setImageXxx()方法 注意这个函数先于构造函数调用之前调用
  *
  * @param bm
  */
 @Override
 public void setImageBitmap(Bitmap bm) {
  super.setImageBitmap(bm);
  mBitmap = bm;
  setup();
 }
 
 @Override
 public void setImageDrawable(Drawable drawable) {
  super.setImageDrawable(drawable);
  mBitmap = getBitmapFromDrawable(drawable);
  setup();
 }
 
 @Override
 public void setImageResource(@DrawableRes int resId) {
  super.setImageResource(resId);
  mBitmap = getBitmapFromDrawable(getDrawable());
  setup();
 }
 
 @Override
 public void setImageURI(Uri uri) {
  super.setImageURI(uri);
  mBitmap = getBitmapFromDrawable(getDrawable());
  setup();
 }
 
 @Override
 public void setColorFilter(ColorFilter cf) {
  if (cf == mColorFilter) {
   return;
  }
 
  mColorFilter = cf;
  mBitmapPaint.setColorFilter(mColorFilter);
  invalidate();
 }
 
 /**
  * Drawable转Bitmap
  *
  * @param drawable
  * @return
  */
 private Bitmap getBitmapFromDrawable(Drawable drawable) {
  if (drawable == null) {
   return null;
  }
 
  if (drawable instanceof BitmapDrawable) {
   // 通常来说 我们的代码就是执行到这里就返回了。返回的就是我们最原始的bitmap
   return ((BitmapDrawable) drawable).getBitmap();
  }
 
  try {
   Bitmap bitmap;
 
   if (drawable instanceof ColorDrawable) {
    bitmap = Bitmap.createBitmap(COLORDRAWABLE_DIMENSION,
      COLORDRAWABLE_DIMENSION, BITMAP_CONFIG);
   } else {
    bitmap = Bitmap.createBitmap(drawable.getIntrinsicWidth(),
      drawable.getIntrinsicHeight(), BITMAP_CONFIG);
   }
 
   Canvas canvas = new Canvas(bitmap);
   drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
   drawable.draw(canvas);
   return bitmap;
  } catch (OutOfMemoryError e) {
   return null;
  }
 }
 
 /**
  * 这个函数很关键，进行图片画笔边界画笔(Paint)一些重绘参数初始化：
  * 构建渲染器BitmapShader用Bitmap来填充绘制区域,设置样式以及内外圆半径计算等，
  * 以及调用updateShaderMatrix()函数和 invalidate()函数；
  */
 private void setup() {
  // 因为mReady默认值为false,所以第一次进这个函数的时候if语句为真进入括号体内
  // 设置mSetupPending为true然后直接返回，后面的代码并没有执行。
  if (!mReady) {
   mSetupPending = true;
   return;
  }
  // 防止空指针异常
  if (mBitmap == null) {
   return;
  }
  // 构建渲染器，用mBitmap位图来填充绘制区域 ，参数值代表如果图片太小的话 就直接拉伸
  mBitmapShader = new BitmapShader(mBitmap, Shader.TileMode.CLAMP,
    Shader.TileMode.CLAMP);
  // 设置图片画笔反锯齿
  mBitmapPaint.setAntiAlias(true);
  // 设置图片画笔渲染器
  mBitmapPaint.setShader(mBitmapShader);
  // 设置边界画笔样式
  mBorderPaint.setStyle(Paint.Style.STROKE);// 设画笔为空心
  mBorderPaint.setAntiAlias(true);
  mBorderPaint.setColor(mBorderColor); // 画笔颜色
  mBorderPaint.setStrokeWidth(mBorderWidth);// 画笔边界宽度
  // 这个地方是取的原图片的宽高
  mBitmapHeight = mBitmap.getHeight();
  mBitmapWidth = mBitmap.getWidth();
  // 设置含边界显示区域，取的是CircleImageView的布局实际大小，为方形，查看xml也就是160dp(240px)
  // getWidth得到是某个view的实际尺寸
  mBorderRect.set(0, 0, getWidth(), getHeight());
  // 计算
  // 圆形带边界部分（外圆）的最小半径，取mBorderRect的宽高减去一个边缘大小的一半的较小值（这个地方我比较纳闷为什么求外圆半径需要先减去一个边缘大小）
  mBorderRadius = Math.min((mBorderRect.height() - mBorderWidth) / 2,
    (mBorderRect.width() - mBorderWidth) / 2);
  // 初始图片显示区域为mBorderRect（CircleImageView的布局实际大小）
  mDrawableRect.set(mBorderRect);
  if (!mBorderOverlay) {
   // demo里始终执行
   // 通过inset方法
   // 使得图片显示的区域从mBorderRect大小上下左右内移边界的宽度形成区域，查看xml边界宽度为2dp（3px）,所以方形边长为就是160-4=156dp(234px)
   mDrawableRect.inset(mBorderWidth, mBorderWidth);
  }
  // 这里计算的是内圆的最小半径，也即去除边界宽度的半径
  mDrawableRadius = Math.min(mDrawableRect.height() / 2,
    mDrawableRect.width() / 2);
  // 设置渲染器的变换矩阵也即是mBitmap用何种缩放形式填充
  updateShaderMatrix();
  // 手动触发ondraw()函数 完成最终的绘制
  invalidate();
 }
 
 /**
  * 这个函数为设置BitmapShader的Matrix参数，设置最小缩放比例，平移参数。 作用：保证图片损失度最小和始终绘制图片正中央的那部分
  */
 private void updateShaderMatrix() {
  float scale;
  float dx = 0;
  float dy = 0;
  mShaderMatrix.set(null);
  // 这里不好理解 这个不等式也就是(mBitmapWidth / mDrawableRect.width()) >
  // (mBitmapHeight / mDrawableRect.height())
  // 取最小的缩放比例
  if (mBitmapWidth * mDrawableRect.height() > mDrawableRect.width()
    * mBitmapHeight) {
   // y轴缩放 x轴平移 使得图片的y轴方向的边的尺寸缩放到图片显示区域（mDrawableRect）一样）
   scale = mDrawableRect.height() / (float) mBitmapHeight;
   dx = (mDrawableRect.width() - mBitmapWidth * scale) * 0.5f;
  } else {
   // x轴缩放 y轴平移 使得图片的x轴方向的边的尺寸缩放到图片显示区域（mDrawableRect）一样）
   scale = mDrawableRect.width() / (float) mBitmapWidth;
   dy = (mDrawableRect.height() - mBitmapHeight * scale) * 0.5f;
  }
  // shaeder的变换矩阵，我们这里主要用于放大或者缩小。
  mShaderMatrix.setScale(scale, scale);
  // 平移
  mShaderMatrix.postTranslate((int) (dx + 0.5f) + mDrawableRect.left,
    (int) (dy + 0.5f) + mDrawableRect.top);
  // 设置变换矩阵
  mBitmapShader.setLocalMatrix(mShaderMatrix);
 }
}

<com.xxx.xxx.ui.view.CircleImageView
    android:layout_width="45dp"
    android:layout_height="45dp"
    android:src="@mipmap/ic_header"
    app:border_color="@color/bg_dddddd"
    android:layout_gravity="center_vertical"
    android:layout_marginRight="10dp"
    app:border_size="1dp"
    />