Android圓角頭像工具類詳解
阿新 • • 發佈：2020-07-23
很多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,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,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,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,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"
/>以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支援我們。