区域Region详解

Region类图形游戏开发中比较常用，判断点是否在指定区域内碰撞。还能在自定义View中指定区域为可点击就是使用Region完成的。首先需要明白Region表示的是Canvas图层上的某一块封闭的区域。

1、构造Region

Region有几个构造函数，或者通过方法为空的Region对象设置区域。

1.1、构造

①Region()：创建一个空白区域，结合后面的方法设置该区域

②Region(Region region)：从另一个region区域中复制一块相同的区域

③Region(Rect r)：创建一块Rect矩形区域

④Region(int left, int top, int right, int bottom)

1.2、set方法

构造的空Region可以通过一系列的set方法设置指定区域，不过需要注意每次set都会替换掉之前Region中的区域范围。

①set(Region region)：将区域设置为指定区域

②set(Rect r)：将区域设置为指定的矩形

③set(int left, int top, int right, int bottom)：将区域设置为指定的矩形

④setEmpty()：将区域设置为空区域

⑤setPath(Path path,Region clip)：将path形成的路径和clip形成的区域取交集，获得一个交集区域

/**
     * 将区域设置为路径和剪辑所描述的区域。
     * 如果结果区域为非空，则返回true。 
     * 这将产生与该路径将绘制的像素相同的区域（不带抗锯齿）。
     *
     * @param path 用来构造区域的路径
     * @param clip 第一个参数path所构成的路径取交集，并将该交集设为最终区域。
     */
    public boolean setPath(@NonNull Path path, @NonNull Region clip) {
        return nativeSetPath(mNativeRegion, path.readOnlyNI(), clip.mNativeRegion);
    }

2、Region方法

介绍Region类的常用方法。包括Region之间的相互op操作、获取

2.1、union/op运算

①op(Region region, Op op)：在此区域和指定区域region上执行指定的Op

②op(Rect r, Op op)：在此区域和指定区域Rect执行指定的Op

③op(int left, int top, int right, int bottom, Op op)

④op(Rect rect, Region region, Op op)

⑤op(Region region1, Region region2,Op op)

⑥union(Rect r)：当前区域和指定矩形取并集，将Rect区域加入到当前区域中。

2.2、getBound

获取区域Region的矩形位置，有多个重载方法，除了参数有区别，返回值也有区别。

①Rect getBounds()：返回一个新的Rect集到区域的边界。如果该区域为空，则Rect将设置为[0，0，0，0]

②boolean getBounds(Rect r)：将矩形r设置为该区域的边界。如果该区域为空，则剩余部分将设置为[0，0，0，0]

③Path getBoundaryPath()：将区域的边界作为新路径返回。如果该区域为空，则路径也将为空。

④boolean getBoundaryPath(@NonNull Path path)：将路径path设置为区域的边界。如果该区域为empty，则路径也将为empty。

2.3、contains

①contains(int x, int y)：判断一个点(x，y)是否在某个区域内

②quickContains(Rect r)：如果区域是单个矩形（不复杂）并且包含指定的矩形，则返回true。返回false不能保证该区域不包含该矩形的部分，但是返回true可以保证该区域包含该矩形。

③quickContains(int left, int top, int right,int bottom)

2.4、is方法

Region类中还有三个is判断方法，这三个方法都是Native方法。

①isComplex()：如果区域包含多个矩形，则返回true

②isRect()：如果区域包含单个矩形，则返回true

③isEmpty()：如果该区域为空，则返回true

3、Op操作

前面介绍的方法中有提到Region.Op类型，这个是定义在Region类中的枚举，定义了各种运算逻辑，现在来结合实例了解其中的实际含义。

3.1、Op枚举

操作符定义在Region类内部的枚举Op

// the native values for these must match up with the enum in SkRegion.h
    public enum Op {
        DIFFERENCE(0),        //补集
        INTERSECT(1),         //交集
        UNION(2),             //并集
        XOR(3),               //异并集
        REVERSE_DIFFERENCE(4),//反转补集
        REPLACE(5);           //替换
    }

3.2、示例

①DIFFERENCE 补集

②INTERSECT 交集

③UNION 并集

④XOR 异并集

⑤REVERSE_DIFFERENCE 反转补集

⑥REPLACE 替换

例：

//构造两个矩形Rect
    Rect rect1 = new Rect(100, 100, 400, 200);
    Rect rect2 = new Rect(200, 0, 300, 300);
    
    //利用矩形构造两块区域
    Region region1 = new Region(rect1);
    Region region2 = new Region(rect2);

onDraw(Canvas )方法中先绘制出矩形区域对照，再对两个区域进行Op操作

@Override
    protected void onDraw(final Canvas canvas) {
        super.onDraw(canvas);
        //先绘制出矩形区域对照
        canvas.drawRect(rect1, mPaint);
        canvas.drawRect(rect2, mPaint);
        
        //对两个区域进行Op操作
        region1.op(region2, Region.Op.REPLACE  );
        
        //画笔设置不同的颜色，和FILL填充模式，绘制操作后的Region区域
        mPaint.setStyle(Paint.Style.FILL);
        mPaint.setColor(Color.GREEN);
        drawRegion(canvas, region1, mPaint);
    }

绘制Region区域，View中没有单独绘制Region的方法，需要手动实现一个drawRegion()方法

private void drawRegion(Canvas canvas, Region region, Paint paint) {
        RegionIterator iterator = new RegionIterator(region);
        Rect rect = new Rect();
        while (iterator.next(rect)) {
            canvas.drawRect(rect, paint);
        }
    }