【Android UI】Canvas 画布 ② ( Canvas 状态栈 | Canvas#restoreToCount 状态栈出栈到指定层级 )

韩曙亮

发布于 2023-03-30 16:03:53

4670

发布于 2023-03-30 16:03:53

文章被收录于专栏：韩曙亮的移动开发专栏

文章目录

一、Canvas#restoreToCount 状态栈出栈到指定层级

Canvas 状态保存机制中 , 存在两个栈结构 , 分别是状态栈和图层栈 ;

其中图层栈又称为 Layer 栈 ;

一、Canvas#restoreToCount 状态栈出栈到指定层级

调用 Canvas#restoreToCount(int saveCount) 方法 , 可以指定出栈到某层 ;

如下图所示 , 已经调用了 5 次 Canvas#save() 方法 ,

如果直接调用 Canvas#restoreToCount(1) , 可以直接回退到原点坐标也就是之前调用的 5 次 Canvas#save() 全部作废 ;
如果直接调用 Canvas#restoreToCount(3) , 那么之前的调用的 2 次 Canvas#save() 作废 , 相当于调用了 3 次 Canvas#save() 方法 ;

Canvas#restoreToCount(int saveCount) 方法函数原型如下 :

    /**
     * 在save count达到saveCount后，弹出对save（）的任何调用的有效方法。
     * saveCount小于1是一个错误。
     *
     * Example:
     *    int count = canvas.save();
     *    ... // more calls potentially to save()
     *    canvas.restoreToCount(count);
     *    // now the canvas is back in the same state it was before the initial
     *    // call to save().
     *
     * @param saveCount The save level to restore to.
     */
    public void restoreToCount(int saveCount) {
        if (saveCount < 1) {
            if (!sCompatibilityRestore || !isHardwareAccelerated()) {
                // do nothing and throw without restoring
                throw new IllegalArgumentException(
                        "Underflow in restoreToCount - more restores than saves");
            }
            // compat behavior - restore as far as possible
            saveCount = 1;
        }
        nRestoreToCount(mNativeCanvasWrapper, saveCount);
    }

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2022-07-10，如有侵权请联系 cloudcommunity@tencent.com 删除

android