方法介绍
- public boolean clipPath (Path path)
- public boolean clipPath (Path path, Region.Op op)
- public boolean clipRect (Rect rect)
- public boolean clipRect (Rect rect, Region.Op op)
这些方法都是用于在画布上裁剪对应的区域，只不过Rect是一个矩形，Path是一个自定义路径，还有另外一个参数是Region.Op ,它指定了不同的方式来剪切区域,为了更好的理解这些参数，这里以上一次裁剪区域为A，当前裁剪区域为B做以表示：
- DIFFERENCE ：裁剪差异部分，具体为A - A∩B
- INTERSECT：裁剪两者相交的部分，A∩B
- UNION：裁剪两者所有区域，A∪B
- XOR：exclusive OR的简写，翻译为异或，也就是两者重叠部分为0，不重叠部分为1，自然裁剪出来的就是不重叠的部分，也就是A∪B - A∩B
- REVERSE_DIFFERENCE：裁剪差异部分，具体为B - A∩B
- REPLACE：B的裁剪区域会覆盖A的区域，B
当方法不指定裁剪模式时，默认为INTERSECT
说明：上一次裁剪区域指的是什么？指的就是在你调用最新的clipxxx之前所形成的区域，当然clipxxx前也很有可能调用了多次clip，但你这次调用的clipxxx，永远相对的之前所形成的区域。
通常我们理解的clip(裁剪)，是对已经存在的图形进行clip的。但是，在Android上是对canvas（画布）上进行clip的，要在画图之前对canvas进行clip，如果画图之后再对canvas进行clip不会影响到已经画好的图形。一定要记住clip是针对canvas而非图形。
由于本人当时对这些方法及参数特别不理解，经过查看多篇博客，再加上自己的测试，最终明白了，上面的参数解释已经是我自己所能表达的最清楚的程度了。不过这里还是给出各种的测试效果，来更好的理解这些方法。
剪裁模式示例
初始代码
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
mPaint.setAntiAlias(true);
mPaint.setColor(Color.RED);
RectF rectF = new RectF(100, 100, 400, 400);
canvas.drawColor(Color.BLUE);
canvas.drawRect(rectF, mPaint);
canvas.drawCircle(400, 250, 150, mPaint);
}
只是画了一个300x300的红色矩形，和一个半径为150，圆心在正方形右边中点的红色圆
效果如图：
Region.Op.INTERSECT
测试代码
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
mPaint.setAntiAlias(true);
mPaint.setColor(Color.RED);
RectF rectF = new RectF(100, 100, 400, 400);
canvas.drawColor(Color.BLUE);
canvas.drawRect(rectF, mPaint);
canvas.drawCircle(400, 250, 150, mPaint);
canvas.clipRect(rectF); // 1.
Path path = new Path();
path.addCircle(400, 250, 150, Path.Direction.CCW);
canvas.clipPath(path, Region.Op.INTERSECT); // 2.
canvas.drawColor(Color.GREEN); // 3.
}
- 第一次clipRect，默认裁剪模式就是INTERSECT，对于它上一个裁剪区域就是整个Canvas，此时会裁剪出一个300x300的可用于绘制的矩形
- 第二次clipPath则是基于刚才裁剪出的矩形区域来说，裁剪模式为INTERSECT，此时形成的区域就是下图中绿色区域
-
通过绘制绿色可以看出刚才裁剪出来的区域
效果图：
之后的测试都是通过改变注释2代码处模式进行，就不在贴代码了
| Region.Op.DIFFERENCE | Region.Op.REVERSE_DIFFERENCE | Region.Op.UNION | Region.Op.REPLACE | Region.Op.XOR |
|---|---|---|---|---|
 |
 |
 |
 |
 |
效果图结合着参数解释应该就可以很好的理解了。
Android9.0 Region.Op参数使用变更
Android 9.0 中如果在使用绘图裁剪功能时设置了除 Region.Op.INTERSECT 或 Region.Op.DIFFERENCE 以外的类型，就会抛出以下异常：
java.lang.IllegalArgumentException: Invalid Region.Op - only INTERSECT and DIFFERENCE are allowed
具体原因是官方废弃了那几个具有 Region.Op 参数的裁剪方法，如 clipRect(@NonNull RectF rect, @NonNull Region.Op op) ：
@Deprecated
public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) {
checkValidClipOp(op);
return nClipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom,
op.nativeInt);
}
private static void checkValidClipOp(@NonNull Region.Op op) {
if (sCompatiblityVersion >= Build.VERSION_CODES.P
&& op != Region.Op.INTERSECT && op != Region.Op.DIFFERENCE) {
throw new IllegalArgumentException(
"Invalid Region.Op - only INTERSECT and DIFFERENCE are allowed");
}
}
对于这个问题，可以通过以下方法进行适配：
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
canvas.clipPath(path);
} else {
canvas.clipPath(path, Region.Op.XOR);// REPLACE、UNION 等类型
}
