Canvas中clipRect、clipPath 剪切方法理解

方法介绍

• 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 等类型
}