Android自定义控件之圆形、圆角ImageView

发布时间 - 2026-01-11 00:17:07    点击率:

一、问题在哪里?

问题来源于app开发中一个很常见的场景——用户头像要展示成圆的:

 二、怎么搞?

机智的我,第一想法就是,切一张中间圆形透明、四周与底色相同、尺寸与头像相同的蒙板图片,盖在头像上不就完事了嘛,哈哈哈!

在背景纯色的前提下,这的确能简单解决问题,但是如果背景没有这么简单呢?

在这种不规则背景下,有两个问题:

1)、背景图常常是适应手机宽度缩放,而头像的尺寸又是固定宽高DP的,所以固定的蒙板图片是没法保证在不同机型上都和背景图案吻合的。

2)、在这种非纯色背景下,哪天想调整一下头像位置就得重新换图片蒙板,实在是太难维护了……

所以呢,既然头像图片肯定是方的,那就就让ImageView圆起来吧。

三、开始干活

基本思路是,自定义一个ImageView,通过重写onDraw方法画出一个圆形的图片来:

public class ImageViewPlus extends ImageView{
  private Paint mPaintBitmap = new Paint(Paint.ANTI_ALIAS_FLAG);
  private Bitmap mRawBitmap;
  private BitmapShader mShader;
  private Matrix mMatrix = new Matrix();
  
  public ImageViewPlus(Context context, AttributeSet attrs) {
    super(context, attrs);
  }
  
  @Override
  protected void onDraw(Canvas canvas) {
    Bitmap rawBitmap = getBitmap(getDrawable());
    if (rawBitmap != null){
      int viewWidth = getWidth();
      int viewHeight = getHeight();
      int viewMinSize = Math.min(viewWidth, viewHeight);
      float dstWidth = viewMinSize;
      float dstHeight = viewMinSize;
      if (mShader == null || !rawBitmap.equals(mRawBitmap)){
        mRawBitmap = rawBitmap;
        mShader = new BitmapShader(mRawBitmap, TileMode.CLAMP, TileMode.CLAMP);
      }
      if (mShader != null){
        mMatrix.setScale(dstWidth / rawBitmap.getWidth(), dstHeight / rawBitmap.getHeight());
        mShader.setLocalMatrix(mMatrix);
      }
      mPaintBitmap.setShader(mShader);
      float radius = viewMinSize / 2.0f;
      canvas.drawCircle(radius, radius, radius, mPaintBitmap);
    } else {
      super.onDraw(canvas);
    }
  }

  private Bitmap getBitmap(Drawable drawable){
    if (drawable instanceof BitmapDrawable){
      return ((BitmapDrawable)drawable).getBitmap();
    } else if (drawable instanceof ColorDrawable){
      Rect rect = drawable.getBounds();
      int width = rect.right - rect.left;
      int height = rect.bottom - rect.top;
      int color = ((ColorDrawable)drawable).getColor();
      Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
      Canvas canvas = new Canvas(bitmap);
      canvas.drawARGB(Color.alpha(color), Color.red(color), Color.green(color), Color.blue(color));
      return bitmap;
    } else {
      return null;
    }
  }
}

分析一下代码:

canvas.drawCircle 决定了画出来的形状是圆形,而圆形的内容则是通过 mPaintBitmap.setShader 搞定的。

其中,BitmapShader需要设置Bitmap填充ImageView的方式(CLAMP:拉伸边缘, MIRROR:镜像, REPEAT:整图重复)。

这里其实设成什么不重要,因为我们实际需要的是将Bitmap按比例缩放成跟ImageView一样大,而不是预置的三种效果。

所以,别忘了 mMatrix.setScale 和 mShader.setLocalMatrix 一起用,将图片缩放一下。

四、更多玩法 —— 支持边框

看下面的效果图,如果想给圆形的头像上加一个边框,该怎么搞呢?

public class ImageViewPlus extends ImageView{
  private Paint mPaintBitmap = new Paint(Paint.ANTI_ALIAS_FLAG);
  private Paint mPaintBorder = new Paint(Paint.ANTI_ALIAS_FLAG);
  private Bitmap mRawBitmap;
  private BitmapShader mShader;
  private Matrix mMatrix = new Matrix();
  private float mBorderWidth = dip2px(15);
  private int mBorderColor = 0xFF0080FF;
  
  public ImageViewPlus(Context context, AttributeSet attrs) {
    super(context, attrs);
  }
  
  @Override
  protected void onDraw(Canvas canvas) {
    Bitmap rawBitmap = getBitmap(getDrawable());
    if (rawBitmap != null){
      int viewWidth = getWidth();
      int viewHeight = getHeight();
      int viewMinSize = Math.min(viewWidth, viewHeight);
      float dstWidth = viewMinSize;
      float dstHeight = viewMinSize;
      if (mShader == null || !rawBitmap.equals(mRawBitmap)){
        mRawBitmap = rawBitmap;
        mShader = new BitmapShader(mRawBitmap, TileMode.CLAMP, TileMode.CLAMP);
      }
      if (mShader != null){
        mMatrix.setScale((dstWidth - mBorderWidth * 2) / rawBitmap.getWidth(), (dstHeight - mBorderWidth * 2) / rawBitmap.getHeight());
        mShader.setLocalMatrix(mMatrix);
      }
      mPaintBitmap.setShader(mShader);
      mPaintBorder.setStyle(Paint.Style.STROKE);
      mPaintBorder.setStrokeWidth(mBorderWidth);
      mPaintBorder.setColor(mBorderColor);
      float radius = viewMinSize / 2.0f;
      canvas.drawCircle(radius, radius, radius - mBorderWidth / 2.0f, mPaintBorder);
      canvas.translate(mBorderWidth, mBorderWidth);
      canvas.drawCircle(radius - mBorderWidth, radius - mBorderWidth, radius - mBorderWidth, mPaintBitmap);
    } else {
      super.onDraw(canvas);
    }
  }

  private Bitmap getBitmap(Drawable drawable){
    if (drawable instanceof BitmapDrawable){
      return ((BitmapDrawable)drawable).getBitmap();
    } else if (drawable instanceof ColorDrawable){
      Rect rect = drawable.getBounds();
      int width = rect.right - rect.left;
      int height = rect.bottom - rect.top;
      int color = ((ColorDrawable)drawable).getColor();
      Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
      Canvas canvas = new Canvas(bitmap);
      canvas.drawARGB(Color.alpha(color), Color.red(color), Color.green(color), Color.blue(color));
      return bitmap;
    } else {
      return null;
    }
  }
  
  private int dip2px(int dipVal)
  {
    float scale = getResources().getDisplayMetrics().density;
    return (int)(dipVal * scale + 0.5f);
  }
}

看代码中,加边框实际上就是用实心纯色的 Paint 画了一个圆边,在此基础上画上原来的头像即可。

需要的注意的地方有三个:

1)、圆框的半径不是 radius ,而应该是 radius - mBorderWidth / 2.0f 。想象着拿着笔去画线,线其实是画在右图中白色圈的位置,只不过它很粗。

2)、在ImageView大小不变的基础上,头像的实际大小要比没有边框的时候小了,所以 mMatrix.setScale 的时候要把边框的宽度去掉。

3)、画头像Bitmap的时候不能直接 canvas.drawCircle(radius, radius, radius - mBorderWidth, mPaintBitmap) ,这样你会发现头像的右侧和下方边缘被拉伸了(右图)

为什么呢?因为 Paint 默认是以左上角为基准开始绘制的,此时头像的实际区域是右图中的红框,而超过红框的部分(圆形的右侧和下方),自然被 TileMode.CLAMP效果沿边缘拉伸了。

所以,需要通过挪动坐标系的位置和调整圆心,才能把头像画在正确的区域(右图绿框)中。

五、更多玩法 —— 支持xml配置

既然有了边框,那如果想配置边框的宽度和颜色该如何是好呢?

基本上两个思路:

1)、给ImageViewPlus加上set接口,设置完成之后通过 invalidate(); 重绘一下即可;

2)、在xml里就支持配置一些自定义属性,这样用起来会方便很多。

这里重点说一下支持xml配置自定义属性。

自定义控件要支持xml配置自定义属性的话,首先需要在 \res\values 里去定义属性:

<?xml version="1.0" encoding="utf-8"?> 
<resources> 
  <attr name="borderColor" format="color" />
  <attr name="borderWidth" format="dimension" />

  <declare-styleable name="ImageViewPlus"> 
    <attr name="borderColor" />
    <attr name="borderWidth" />
  </declare-styleable> 
</resources>

然后在ImageViewPlus的构造函数中去读取这些自定义属性:

private static final int DEFAULT_BORDER_COLOR = Color.TRANSPARENT;
  private static final int DEFAULT_BORDER_WIDTH = 0;
  
  public ImageViewPlus(Context context, AttributeSet attrs) {
    super(context, attrs);
    //取xml文件中设定的参数
    TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ImageViewPlus);
    mBorderColor = ta.getColor(R.styleable.ImageViewPlus_borderColor, DEFAULT_BORDER_COLOR);
    mBorderWidth = ta.getDimensionPixelSize(R.styleable.ImageViewPlus_borderWidth, dip2px(DEFAULT_BORDER_WIDTH));
    ta.recycle();
  }

在xml布局中使用自定义属性:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  xmlns:snser="http://schemas.android.com/apk/res/cc.snser.imageviewplus"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@drawable/wallpaper"
  android:orientation="vertical"
  tools:context="${relativePackage}.${activityClass}" >
  
  <cc.snser.imageviewplus.ImageViewPlus
    android:id="@+id/imgplus"
    android:layout_width="200dp"
    android:layout_height="300dp"
    android:layout_marginBottom="50dp"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true"
    android:src="@drawable/img_square"
    snser:borderColor="#FF0080FF"
    snser:borderWidth="15dp" />
  
</RelativeLayout>

六、更多玩法 —— 圆角ImageView

搞定了圆形ImageView以及对应的边框,那如何实现下面这种圆角的ImageView呢?

 

其实原理上一样,把 canvas.drawCircle 对应改成 canvas.drawRoundRect 就OK了,直接贴代码吧:

public class ImageViewPlus extends ImageView{
  /**
   * android.widget.ImageView
   */
  public static final int TYPE_NONE = 0;
  /**
   * 圆形
   */
  public static final int TYPE_CIRCLE = 1;
  /**
   * 圆角矩形
   */
  public static final int TYPE_ROUNDED_RECT = 2;  
  
  private static final int DEFAULT_TYPE = TYPE_NONE;
  private static final int DEFAULT_BORDER_COLOR = Color.TRANSPARENT;
  private static final int DEFAULT_BORDER_WIDTH = 0;
  private static final int DEFAULT_RECT_ROUND_RADIUS = 0;
  
  private int mType;
  private int mBorderColor;
  private int mBorderWidth;
  private int mRectRoundRadius;
  
  private Paint mPaintBitmap = new Paint(Paint.ANTI_ALIAS_FLAG);
  private Paint mPaintBorder = new Paint(Paint.ANTI_ALIAS_FLAG);
  
  private RectF mRectBorder = new RectF();
  private RectF mRectBitmap = new RectF();
  
  private Bitmap mRawBitmap;
  private BitmapShader mShader;
  private Matrix mMatrix = new Matrix();
  
  public ImageViewPlus(Context context, AttributeSet attrs) {
    super(context, attrs);
    //取xml文件中设定的参数
    TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ImageViewPlus);
    mType = ta.getInt(R.styleable.ImageViewPlus_type, DEFAULT_TYPE);
    mBorderColor = ta.getColor(R.styleable.ImageViewPlus_borderColor, DEFAULT_BORDER_COLOR);
    mBorderWidth = ta.getDimensionPixelSize(R.styleable.ImageViewPlus_borderWidth, dip2px(DEFAULT_BORDER_WIDTH));
    mRectRoundRadius = ta.getDimensionPixelSize(R.styleable.ImageViewPlus_rectRoundRadius, dip2px(DEFAULT_RECT_ROUND_RADIUS));
    ta.recycle();
  }
  
  @Override
  protected void onDraw(Canvas canvas) {
    Bitmap rawBitmap = getBitmap(getDrawable());
    
    if (rawBitmap != null && mType != TYPE_NONE){
      int viewWidth = getWidth();
      int viewHeight = getHeight();
      int viewMinSize = Math.min(viewWidth, viewHeight);
      float dstWidth = mType == TYPE_CIRCLE ? viewMinSize : viewWidth;
      float dstHeight = mType == TYPE_CIRCLE ? viewMinSize : viewHeight;
      float halfBorderWidth = mBorderWidth / 2.0f;
      float doubleBorderWidth = mBorderWidth * 2;
      
      if (mShader == null || !rawBitmap.equals(mRawBitmap)){
        mRawBitmap = rawBitmap;
        mShader = new BitmapShader(mRawBitmap, TileMode.CLAMP, TileMode.CLAMP);
      }
      if (mShader != null){
        mMatrix.setScale((dstWidth - doubleBorderWidth) / rawBitmap.getWidth(), (dstHeight - doubleBorderWidth) / rawBitmap.getHeight());
        mShader.setLocalMatrix(mMatrix);
      }
      
      mPaintBitmap.setShader(mShader);
      mPaintBorder.setStyle(Paint.Style.STROKE);
      mPaintBorder.setStrokeWidth(mBorderWidth);
      mPaintBorder.setColor(mBorderWidth > 0 ? mBorderColor : Color.TRANSPARENT);
      
      if (mType == TYPE_CIRCLE){
        float radius = viewMinSize / 2.0f;
        canvas.drawCircle(radius, radius, radius - halfBorderWidth, mPaintBorder);
        canvas.translate(mBorderWidth, mBorderWidth);
        canvas.drawCircle(radius - mBorderWidth, radius - mBorderWidth, radius - mBorderWidth, mPaintBitmap);
      } else if (mType == TYPE_ROUNDED_RECT){
        mRectBorder.set(halfBorderWidth, halfBorderWidth, dstWidth - halfBorderWidth, dstHeight - halfBorderWidth);
        mRectBitmap.set(0.0f, 0.0f, dstWidth - doubleBorderWidth, dstHeight - doubleBorderWidth);
        float borderRadius = mRectRoundRadius - halfBorderWidth > 0.0f ? mRectRoundRadius - halfBorderWidth : 0.0f;
        float bitmapRadius = mRectRoundRadius - mBorderWidth > 0.0f ? mRectRoundRadius - mBorderWidth : 0.0f;
        canvas.drawRoundRect(mRectBorder, borderRadius, borderRadius, mPaintBorder);
        canvas.translate(mBorderWidth, mBorderWidth);
        canvas.drawRoundRect(mRectBitmap, bitmapRadius, bitmapRadius, mPaintBitmap);
      }
    } else {
      super.onDraw(canvas);
    }
  }

  private int dip2px(int dipVal)
  {
    float scale = getResources().getDisplayMetrics().density;
    return (int)(dipVal * scale + 0.5f);
  }
  
  private Bitmap getBitmap(Drawable drawable){
    if (drawable instanceof BitmapDrawable){
      return ((BitmapDrawable)drawable).getBitmap();
    } else if (drawable instanceof ColorDrawable){
      Rect rect = drawable.getBounds();
      int width = rect.right - rect.left;
      int height = rect.bottom - rect.top;
      int color = ((ColorDrawable)drawable).getColor();
      Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
      Canvas canvas = new Canvas(bitmap);
      canvas.drawARGB(Color.alpha(color), Color.red(color), Color.green(color), Color.blue(color));
      return bitmap;
    } else {
      return null;
    }
  }
}
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  xmlns:snser="http://schemas.android.com/apk/res/cc.snser.imageviewplus"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@drawable/wallpaper"
  android:orientation="vertical"
  tools:context="${relativePackage}.${activityClass}" >
  
  <cc.snser.imageviewplus.ImageViewPlus
    android:id="@+id/imgplus"
    android:layout_width="200dp"
    android:layout_height="300dp"
    android:layout_marginBottom="50dp"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true"
    android:src="@drawable/img_rectangle"
    snser:type="rounded_rect"
    snser:borderColor="#FF0080FF"
    snser:borderWidth="10dp"
    snser:rectRoundRadius="30dp" />
  
</RelativeLayout>
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
  <attr name="type"> 
    <enum name="none" value="0" /> 
    <enum name="circle" value="1" /> 
    <enum name="rounded_rect" value="2" />
  </attr>
  <attr name="borderColor" format="color" />
  <attr name="borderWidth" format="dimension" />
  <attr name="rectRoundRadius" format="dimension" />

  <declare-styleable name="ImageViewPlus"> 
    <attr name="type" />
    <attr name="borderColor" />
    <attr name="borderWidth" />
    <attr name="rectRoundRadius" />
  </declare-styleable>
</resources>

七、Demo源码

Android自定义圆形ImageView

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# Android  # 圆形  # 圆角  # ImageView  # android 实现圆角图片解决方案  # Android中TextView显示圆圈背景或设置圆角的方法  # Android关于Glide的使用(高斯模糊、加载监听、圆角图片)  # Android图片特效:黑白特效、圆角效果、高斯模糊  # Android开发使用自定义View将圆角矩形绘制在Canvas上的方法  # Android中实现EditText圆角的方法  # Android中Glide加载圆形图片和圆角图片实例代码  # android 设置圆角图片实现代码  # Android实现圆角矩形和圆形ImageView的方式  # Android利用Xfermode剪裁圆角  # 自定义  # 在这种  # 画出  # 图中  # 伸了  # 怎么搞  # 蒙板  # 的是  # 右图  # 边缘  # 沿边  # 又是  # 那就  # 背景下  # 基础上  # 则是  # 要把  # 不就  # 三种 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel如何使用withoutEvents方法临时禁用模型事件  香港服务器租用每月最低只需15元?  网站制作公司哪里好做,成都网站制作公司哪家做得比较好,更正规?  Laravel如何实现API资源集合?(Resource Collection教程)  JS经典正则表达式笔试题汇总  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗?  C++用Dijkstra(迪杰斯特拉)算法求最短路径  Laravel用户密码怎么加密_Laravel Hash门面使用教程  晋江文学城电脑版官网 晋江文学城网页版直接进入  如何在企业微信快速生成手机电脑官网?  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办?  成都网站制作公司哪家好,四川省职工服务网是做什么用?  如何快速搭建个人网站并优化SEO?  宙斯浏览器怎么屏蔽图片浏览 节省手机流量使用设置方法  Laravel的辅助函数有哪些_Laravel常用Helpers函数提高开发效率  Laravel Facade的原理是什么_深入理解Laravel门面及其工作机制  如何用狗爹虚拟主机快速搭建网站?  Laravel如何配置任务调度?(Cron Job示例)  昵图网官方站入口 昵图网素材图库官网入口  Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】  网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏?  如何续费美橙建站之星域名及服务?  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  Android Socket接口实现即时通讯实例代码  油猴 教程,油猴搜脚本为什么会网页无法显示?  如何用搬瓦工VPS快速搭建个人网站?  网站建设要注意的标准 促进网站用户好感度!  香港服务器网站推广:SEO优化与外贸独立站搭建策略  如何用PHP工具快速搭建高效网站?  WordPress 子目录安装中正确处理脚本路径的完整指南  用v-html解决Vue.js渲染中html标签不被解析的问题  Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  MySQL查询结果复制到新表的方法(更新、插入)  为什么要用作用域操作符_php中访问类常量与静态属性的优势【解答】  Laravel 419 page expired怎么解决_Laravel CSRF令牌过期处理  动图在线制作网站有哪些,滑动动图图集怎么做?  简历没回改:利用AI润色让你的文字更专业  详解Huffman编码算法之Java实现  Swift开发中switch语句值绑定模式  javascript中数组(Array)对象和字符串(String)对象的常用方法总结  iOS UIView常见属性方法小结  Laravel如何实现本地化和多语言支持?(i18n教程)  公司网站制作价格怎么算,公司办个官网需要多少钱?  Linux系统命令中screen命令详解  ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】  Laravel如何与Inertia.js和Vue/React构建现代单页应用  如何用AI帮你把自己的生活经历写成一个有趣的故事?  宙斯浏览器视频悬浮窗怎么开启 边看视频边操作其他应用教程  Laravel怎么进行浏览器测试_Laravel Dusk自动化浏览器测试入门