一、前言
很久没有更新Android 原生技术内容了,前些年一直在做跨端方向开发,最近换工作用重新回到原生技术,又回到了熟悉但有些生疏的环境,真是感慨万分。
近期也是因为准备做地图交互相关的需求,功能非常复杂,尤其是交互部分,不过再复杂的交互,只要一点点将它拆解,分而治之,问题还是可以解决,就比如接下来要做的放大镜功能。
二、功能设计
该功能的场景是在操作地图时,对于边缘的精细化操作(像素级别的)需要在放大镜里显示正在操作的地图区域。比如
如上图,我在操作地图里的内容时,可以在左上角看到我手指操作的内容。
这里需要支持如下几点:
- 支持设置放大镜的放大倍数
- 支持实时更新放大镜里的内容,手指操作地图时,放大镜要里的内容要一直显示(刷新),手指松开时,放大镜里的内容要清空。
- 放大镜是个圆形。
三、功能实现
分下下来,放大镜的功能实现,拆解下来可以分成两部分来实现。
- 绘制圆形容器。
- 绘制手指操作的区域内容。
接下来我们逐个实现
3.1 绘制圆形容器
关于绘制圆形容器,这里会涉及到Path 路径知识,因为正常的图形都是方形,因此需要图形裁切才行,这里会涉及到canvas.clipPath()API。
具体代码如下:
private Paint paint;// 用于裁剪成圆形private Path clipPath;private void init() {paint = new Paint(Paint.ANTI_ALIAS_FLAG);clipPath = new Path();}@Overrideprotected void onDraw(@NonNull Canvas canvas) {super.onDraw(canvas);// 获取 MagnifierView 的宽高int viewWidth = getWidth();int viewHeight = getHeight();// 计算圆形半径float radius = Math.min(viewWidth, viewHeight) / 2f;clipPath.reset();// 绘制圆形路径clipPath.addCircle(viewHeight / 2f, (float) viewHeight /2,radius,Path.Direction.CW);// 裁切圆形画布canvas.clipPath(clipPath);}
3.2 绘制手指操作区域
放大镜本质就是放大图片,而图片在Android 里面就是Bitmap。这里有个问题。
3.2.1 如何获取当前手指操作View 的Bitmap呢?
答案是用getDrawingCache()。
具体实现如下:
setDrawingCacheEnabled(true);
Bitmap bitmap = Bitmap.createBitmap(getDrawingCache());
setDrawingCacheEnabled(false);
当然,这里里的Bitmap是一整个View的,我们仅想放大手指操作(比如点击、滑动)区域的Bitmap,这就需要手指所在的坐标区域。
我们可以自定义一个View,然后重写它的onTouchEvent方法,通过event.getX(), event.getY()获取手指实时操作的坐标,然后传给放大镜View(比如我们这次自定义的放大镜MagnifierView)里面,连同前面的Bitmap一起传过去。这里可以搞一个回调接口。
public interface MagnifierListener {// 传递放大镜内容void onMagnify(Bitmap bitmap, float x, float y);// 隐藏放大镜void onHideMagnifier();}
3.2.2 绘制操作区域
得到了要绘制的内容Bitmap,接下来就是绘制出来。
绘制Bitmap很简单,就是调用下面的API:
canvas.drawBitmap(bitmap, srcRect, dstRect, paint);
复杂的是计算放大内容的源区域,也就是srcRect。
这里先解释下dstRect,它是定义目标矩形(也就是放大镜自身大小)实现如下:
RectF dstRect = new RectF(0, 0, viewWidth, viewHeight);
接下来我们开始设置srcRect。写到这里我们好像漏了一个关键参数“放大倍数”。
// 放大倍数
private static final float SCALE_FACTOR = 2.0f;
因为我们要显示的区域和放大倍数有直接关联。srcRect 是一个Rect 对象,它里面有四个参数(左上右下),相当于当前显示区域范围,计算公式如下:
// 计算放大内容的源区域
float srcLeft = focusX - (viewWidth / SCALE_FACTOR) / 2;
float srcTop = focusY - (viewHeight / SCALE_FACTOR) / 2;
float srcRight = focusX + (viewWidth / SCALE_FACTOR) / 2;
float srcBottom = focusY + (viewHeight / SCALE_FACTOR) / 2;
先来解释下上面的公式意义,focusX对应的就是手指操作的x坐标,即event.getX(),focusY 同理则是event.getY()。
SCALE_FACTOR 是放大倍数。
因为我们想要显示的是“手指为中心,显示区域大小是当前放大镜的面积”,因此需要(viewWidth / SCALE_FACTOR) / 2,这里用focusX是确定左边界的位置。后面参数计算和前面差不多,这里我不重复解释。不过写到这里还不算完成。为了防止越界,这里还需要做一次矫正防护:
// 防止越界
srcLeft = Math.max(0, srcLeft);
srcTop = Math.max(0, srcTop);
srcRight = Math.min(bitmap.getWidth(), srcRight);
srcBottom = Math.min(bitmap.getHeight(), srcBottom);
最后的放大区域代码如下:
// 计算放大内容的源区域float srcLeft = focusX - (viewWidth / SCALE_FACTOR) / 2;float srcTop = focusY - (viewHeight / SCALE_FACTOR) / 2;float srcRight = focusX + (viewWidth / SCALE_FACTOR) / 2;float srcBottom = focusY + (viewHeight / SCALE_FACTOR) / 2;// 防止越界srcLeft = Math.max(0, srcLeft);srcTop = Math.max(0, srcTop);srcRight = Math.min(bitmap.getWidth(), srcRight);srcBottom = Math.min(bitmap.getHeight(), srcBottom);// 定义源矩形(放大的内容区域)Rect srcRect = new Rect((int) srcLeft,(int) srcTop,(int) srcRight,(int) srcBottom);
3.3 小结
这里附上这个功能的完整代码:
/*** author : coffer* date : 2025/1/11* description : 放大镜视图*/
public class MagnifierView extends View {private float focusX = 0f; // 放大内容的中心点Xprivate float focusY = 0f; // 放大内容的中心点Y// 要放大的内容private Bitmap bitmap;private Paint paint;// 用于裁剪成圆形private Path clipPath;// 放大倍数private static final float SCALE_FACTOR = 2.0f;// 是否可以显示private boolean isVisible = false;public MagnifierView(Context context) {super(context);init();}public MagnifierView(Context context, @Nullable AttributeSet attrs) {super(context, attrs);init();}public MagnifierView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {super(context, attrs, defStyleAttr);init();}private void init() {paint = new Paint(Paint.ANTI_ALIAS_FLAG);clipPath = new Path();}/*** 设置放大镜的内容和位置*/public void setFocus(Bitmap bitmap, float x, float y) {this.bitmap = bitmap;this.focusX = x;this.focusY = y;this.isVisible = true;invalidate(); // 触发重绘}/*** 隐藏放大镜*/public void hide() {this.isVisible = false;invalidate();}@Overrideprotected void onDraw(@NonNull Canvas canvas) {super.onDraw(canvas);if (!isVisible || bitmap == null) {return;}// 获取 MagnifierView 的宽高int viewWidth = getWidth();int viewHeight = getHeight();// 计算圆形半径float radius = Math.min(viewWidth, viewHeight) / 2f;clipPath.reset();clipPath.addCircle(viewHeight / 2f, (float) viewHeight /2,radius,Path.Direction.CCW);canvas.clipPath(clipPath);// 计算放大内容的源区域float srcLeft = focusX - (viewWidth / SCALE_FACTOR) / 2;float srcTop = focusY - (viewHeight / SCALE_FACTOR) / 2;float srcRight = focusX + (viewWidth / SCALE_FACTOR) / 2;float srcBottom = focusY + (viewHeight / SCALE_FACTOR) / 2;// 防止越界srcLeft = Math.max(0, srcLeft);srcTop = Math.max(0, srcTop);srcRight = Math.min(bitmap.getWidth(), srcRight);srcBottom = Math.min(bitmap.getHeight(), srcBottom);// 定义源矩形(放大的内容区域)Rect srcRect = new Rect((int) srcLeft,(int) srcTop,(int) srcRight,(int) srcBottom);// 定义目标矩形(放大镜自身大小)RectF dstRect = new RectF(0, 0, viewWidth, viewHeight);// 绘制放大内容canvas.drawBitmap(bitmap, srcRect, dstRect, paint);}
}
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"android:shape="oval"><stroke android:color="#abf4db"android:width="1dp"/></shape>
上面的这个drawable 可有可无,这里这是方便测试用。
四、总结
一开始接到这个需求的时候我是真的有些懵,因为以前从来没有写过。不过后来在仔细拆分问题后,觉的还是可以实现的。这里我要着重感谢ChatGPT,它给了我很大的帮助,就比如这个功能的实现,它就给了我思路,就像老师一样,能从它身上学到很多技能。
但是,请注意!不能完全依赖它,即使AI 帮你做了,你也必须要深入搞懂背后的原理,要把知识吸收到自己大脑思维中,否则未来你将会被AI取代!!!