この節のはじめに:

この節では引き続きAndroid描画シリーズの詳解、Canvas API詳解(Part 2)を紹介します。今日解説するのはCanvasのClipXxxメソッド群です!ドキュメントで提供されているClipメソッドには3つのタイプがあります:clipPath( ),clipRect( ),clipRegion( );

Path、Rect、Regionの異なる組み合わせによって、ほぼ任意の形状のクリップ領域をサポートできます!

Path:開いたり閉じたりした曲線、線で構成される複雑な図形

Rect:矩形領域

Region:領域の組み合わせと理解できます。例えば、2つの領域を加算、減算、結合、排他的論理和などができます!

Region.OpはRegionがサポートする領域間演算の種類を定義しています!後ほど説明します。もう1点言っておくと、普段私たちが理解している「切り抜き」は既存の図形に対してClipを行うかもしれませんが、AndroidではCanvasに対してClipを行うのは描画前に行う必要があります。描画後にCanvasへClipしても、すでに描かれた図形には影響しません。Clipは図形ではなくCanvasに対して行うことを覚えておいてください。さて、余計な話はやめて、本節の内容を始めましょう!

公式APIドキュメント:Canvas


1.Region.Opの組み合わせ方式の詳解

実際の難所はこれに尽きます。Regionは領域を表し、Canvasレイヤー上のある閉じた領域を示します!もちろん、時間があればこのクラスを自分でじっくり調べてもいいですが、私たちが通常注目するのはその列挙値(enum値)の1つです:Op

それでは、各列挙値の役割を見ていきましょう。2つのクリップ領域AとBを仮定し、Region.Opの対応する列挙値を呼び出すとします:

DIFFERENCE:AとBの差集合範囲、すなわちA - B。この範囲内の描画内容のみが表示されます。

INTERSECT:すなわちAとBの共通部分範囲、この範囲内の描画内容のみが表示されます。

UNION:すなわちAとBの和集合範囲、すなわち両方が含む範囲の描画内容はすべて表示されます。

XOR:AとBのXOR(対称差)範囲、この例ではAとBの和集合からAとBの共通部分を除いた範囲で、この範囲内の描画内容のみが表示されます。

REVERSE_DIFFERENCE:BとAの差集合範囲、すなわちB - A。この範囲内の描画内容のみが表示されます。

REPLACE:AとBの集合の状態に関係なく、Bの範囲はすべて表示されます。Aと共通部分があれば、Aの共通部分の範囲を上書きします。

集合を学んだことがあれば、Venn図(ベン図)を描けば一目瞭然です。学んだことがない?大丈夫、実際の結果を例で試してみましょう!ブラシを初期化して矩形を描くメソッドを書きます:

private void init() {
    mPaint = new Paint();
    mPaint.setAntiAlias(true);
    mPaint.setStrokeWidth(6);
    mPaint.setColor(getResources().getColor(R.color.blush));
}

private void drawScene(Canvas canvas){
    canvas.drawRect(0, 0, 200, 200, mPaint);
}

Op.DIFFERENCE:

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(50, 50, 150, 150, Region.Op.DIFFERENCE); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです:

AとBの差集合 = A - (AとBの共通部分)


Op.INTERSECT:

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(50, 50, 150, 150, Region.Op.INTERSECT); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです:AとBの共通部分 = AとBが交わる部分


Op.UNION:

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(40, 40, 140, 140, Region.Op.UNION); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです:AとBの和集合 = Aの領域 + Bの領域


Op.XOR:

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(50, 50, 150, 150, Region.Op.XOR); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです:AとBのXOR(対称差) = AとBの和集合 - AとBの共通部分


Op.REVERSE_DIFFERENCE:

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(50, 50, 150, 150, Region.Op.REVERSE_DIFFERENCE); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです:BとAの差集合 = B - (AとBの共通部分)


Op.REPLACE

canvas.clipRect(10, 10, 110, 110);        //第一个
canvas.clipRect(50, 50, 150, 150, Region.Op.REPLACE); //第二个
drawScene(canvas);

結果:

まず(10,10)を起点とし、次に(50,50)を起点として、2つの100*100の矩形をクリップした結果は次の通りです::AとBの集合の状態に関係なく、Bの範囲はすべて表示されます。Aと共通部分があれば、Aの共通部分の範囲を上書きします。


2.Region.Opの使用例:

例の参考元:Android 2D Graphics学習(二)、Canvas編2、CanvasクリップとRegion、RegionIterator

実行結果のスクリーンショット:

主要部分のコード MyView.java:

/**
 * Created by Jay on 2015/11/10 0010.
 */
public class MyView extends View{

    private Bitmap mBitmap = null;
    private int limitLength = 0;     //
    private int width;
    private int heigth;
    private static final int CLIP_HEIGHT = 50;

    private boolean status = HIDE;//显示还是隐藏的状态,最开始为HIDE
    private static final boolean SHOW = true;//显示图片
    private static final boolean HIDE = false;//隐藏图片

    public MyView(Context context) {
        this(context, null);
    }

    public MyView(Context context, AttributeSet attrs) {
        super(context, attrs);
        mBitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.img_meizi);
        limitLength = width = mBitmap.getWidth();
        heigth = mBitmap.getHeight();
    }

    public MyView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
    }

    @Override
    protected void onDraw(Canvas canvas) {
        Region region = new Region();
        int i = 0;
        while (i * CLIP_HEIGHT <= heigth) {//计算clip的区域
            if (i % 2 == 0) {
                region.union(new Rect(0, i * CLIP_HEIGHT, limitLength, (i + 1) * CLIP_HEIGHT));
            } else {
                region.union(new Rect(width - limitLength, i * CLIP_HEIGHT, width, (i + 1)
                        * CLIP_HEIGHT));
            }
            i++;
        }
        canvas.clipRegion(region);
        canvas.drawBitmap(mBitmap, 0, 0, new Paint());
        if (status == HIDE) {//如果此时是隐藏
            limitLength -= 10;
            if(limitLength <= 0)
                status=SHOW;
        } else {//如果此时是显示
            limitLength += 5;
            if(limitLength >= width)
                status=HIDE;
        }
        invalidate();
    }
}

実装の分析:

初期化時に幅と高さを取得し、ループします。画像を1本ずつの線に分割すると考えてください。ループ条件は「i × 各線の高さが高さ以下であること」です。そして線は2つの場合に分かれ、呼び出しているのはRegionのunion、つまり結合方式がUNIONのクリップ方法です。最後にその時点の画像を表示するかどうかを判断し、非表示と表示の状況で異なる処理を行い、最後にinvalidate()を呼び出して再描画します!かなり簡単なので、自分で理解してみてください~

もう1点:Canvasの変換はclipRegionには効果がありません。


3.clipRectメソッドの詳解:

clipRectには7つのオーバーロードメソッドがあります:

パラメータの説明は次の通りです::

rect:Rectオブジェクト。クリップ領域の範囲を定義するために使用します。RectとRectFは機能が似ており、精度と提供されるメソッドが異なるだけです。

left:矩形クリップ領域の左端の位置

top:矩形クリップ領域の上端の位置

right:矩形クリップ領域の右端の位置

bottom:矩形クリップ領域の下端の位置

op:クリップ領域の組み合わせ方式

上記の4つの値は浮動小数点数型または整数型にできます。

使用例:

mPaint = new Paint();
mPaint.setAntiAlias(true);
mPaint.setColor(Color.BLACK);
mPaint.setTextSize(60);

canvas.translate(300,300);
canvas.clipRect(100, 100, 300, 300);                //设置显示范围
canvas.drawColor(Color.WHITE);                      //白色背景
canvas.drawText("双11,继续吃我的狗粮...", 150, 300, mPaint); //绘制字符串

実行結果:

上記の例で、気づいたでしょうか?clipRectはCanvasの変換の影響を受けます。白い領域は描画されない領域です。つまりclipRectがクリップするのはキャンバスであり、私たちの描画はこのクリップ後のキャンバス上で行われるのです!その領域を超えたものは表示されません!


4.clipPathメソッドの詳解:

clipRectと比べて、clipPathにはオーバーロードメソッドが2つしかありません。使用方法は非常に簡単で、自分でPathを描画して渡すだけです!

使用例:

ここでは以前ImageViewで書いた円形ImageViewの例を再利用します~

実装コード:

カスタムImageView:RoundImageView.java

/**
 * Created by coder-pig on 2015/7/18 0018.
 */
public class RoundImageView extends ImageView {

    private Bitmap mBitmap;
    private Rect mRect = new Rect();
    private PaintFlagsDrawFilter pdf = new PaintFlagsDrawFilter(0, Paint.ANTI_ALIAS_FLAG);
    private Paint mPaint = new Paint();
    private Path mPath=new Path();
    public RoundImageView(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }


    //传入一个Bitmap对象
    public void setBitmap(Bitmap bitmap) {
        this.mBitmap = bitmap;
    }


    private void init() {
        mPaint.setStyle(Paint.Style.STROKE);
        mPaint.setFlags(Paint.ANTI_ALIAS_FLAG);
        mPaint.setAntiAlias(true);// 抗锯尺
    }


    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        if(mBitmap == null)
        {
            return;
        }
        mRect.set(0,0,getWidth(),getHeight());
        canvas.save();
        canvas.setDrawFilter(pdf);
        mPath.addCircle(getWidth() / 2, getWidth() / 2, getHeight() / 2, Path.Direction.CCW);
        canvas.clipPath(mPath, Region.Op.REPLACE);
        canvas.drawBitmap(mBitmap, null, mRect, mPaint);
        canvas.restore();
    }
}

レイアウトコード:activity_main.xml:

<com.jay.demo.imageviewdemo.RoundImageView
        android:id="@+id/img_round"
        android:layout_width="200dp"
        android:layout_height="200dp"
        android:layout_margin="5px"/>

MainActivity.java:

public class MainActivity extends AppCompatActivity {

    private RoundImageView img_round;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        img_round = (RoundImageView) findViewById(R.id.img_round);
        Bitmap bitmap = BitmapFactory.decodeResource(getResources(),R.mipmap.meinv);
        img_round.setBitmap(bitmap);
    }
}

実行結果のスクリーンショット:

また、この方法で作成した角丸ImageViewはジャギー(ギザギザ)が目立ちます。たとえPaintやCanvasにアンチエイリアスを設定しても効果がありません~高い品質を求めるなら、Xfermode-PorterDuffで画像の混合を設定することで実現でき、基本的にジャギーは発生しません。次を参照してください:Android基礎入門チュートリアル——8.3.6 Paint APIの—— XfermodeとPorterDuff詳解(三)


5.この節のサンプルコードのダウンロード:

CanvasDemo2.zip

XfermodeDemo1.zip


この節のまとめ:

さて、この節ではCanvasのクリップにある3つのメソッド:clipPath()、clipRect()、clipRegion()を解説しました。難しいのは最後のものでしょう。6種類の異なるOpの組み合わせ方ですが、実は難しくありません。集合の概念に過ぎません。最初に置いてあるので、理解してしまえば大丈夫です。clipPath()とclipRect()には特に難しい点はありません~そうそう、今日は11月11日(独身の日)ですが、もうショッピングで散財しましたか~