What is the best alternative to `canvas.clipRect` with `Region.Op.REPLACE`?

后端 未结 1 1844
不思量自难忘°
不思量自难忘° 2020-12-03 01:49

Background

I\'m working on a library that has a lot of canvas drawing instead of multiple views (available here).

The problem

As I work to improv

相关标签:
1条回答
  • 2020-12-03 02:12

    1: All methods that use custom Region.Op are deprecated now, so one can use only two method variants now: clipRect/clipPath (which represents Region.Op.INTERSECT) and clipOutRect/clipOutPath (which represents Region.Op.DIFFERENCE). To achieve function similar to Region.Op.REPLACE one must use save() and restore() methods.

    So previously (with Op.REPLACE) you would call just:

    canvas.clipRect(0, 0, 100, 100); // do some clipping
    canvas.drawLine(...); // do some clipped drawing
    
    canvas.clipRect(200, 200, 400, 400, Region.Op.REPLACE); // replace clipping region to completely different one
    canvas.drawLine(...); // and some other drawing
    

    But now you have to save and restore previous canvas state manually:

    canvas.save();        // IMPORTANT: save current state of clip and matrix (i.e. unclipped state) (let's say it's state #1)
    canvas.clipRect(0, 0, 100, 100); // do some clipping
    canvas.drawLine(...); // do some clipped drawing
    canvas.restore();     // IMPORTANT: get back to previously saved (unclipped) state of the canvas (restores state #1)
    
    canvas.save(); // now save again the current state of canvas (clip and matrix) (it's state #2)
    canvas.clipRect(200, 200, 400, 400); // now we can do some other clipping (as we would do with Region.Op.REPLACE before)
    canvas.drawLine(...); // and some other drawing
    canvas.restore(); // get back go previously saved state (to state #2)
    

    Note Canvas is internally using stack, so you can even call save() multiple times at different moments. You just can't call canvas.restore() more times than the canvas.save() was called.

    Also important note is that call to canvas.restore() changes the clip rect (to the same value it was when canvas.save() was called). So you must carefully place the restore() call after all the drawing methods that needs the applied clipping.

    2: Probably because of some performance optimizations. I think I read somewhere (I couldn't find it now) that for hardware acceleration on GPU they can use only INTERSECT / DIFFERENCE clip operations and other ones must fall-back to CPU processing. That might be the reason.

    EDIT: Here is some related answer, that since ICS with enabled HW acceleration some ClipRect ops are not supported.

    3: As they say in documentation, it will stop working in Android P (probably only when targeting Android P):

    As of API Level API level Build.VERSION_CODES.P only INTERSECT and DIFFERENCE are valid Region.Op parameters.

    0 讨论(0)
提交回复
热议问题