• save：保存畫布的狀態
• restore：將畫布保存到之前保存的狀態

這有什么用呢？
當調用 save 保存了畫布的狀態之后，就可以對畫布為所欲為了（調用 Canvas 的平移、放縮、旋轉、錯切、裁剪等操作），反正可以調用 restore 恢復狀態不是嗎？

save 和 restore 一般配套使用。

一個例子：

class CustomView(context: Context?, attrs: AttributeSet?) : View(context, attrs) {

    private val paint: Paint = Paint(Paint.ANTI_ALIAS_FLAG)
    private val bitmap: Bitmap by lazy {
        BitmapFactory.decodeResource(
            resources,
            R.drawable.ic_launcher
        )
    }

    init {
        paint.color = Color.GREEN
    }

    override fun onDraw(canvas: Canvas) {
        super.onDraw(canvas)

        canvas.save()
        val path = Path()
        path.addCircle(bitmap.width / 2.0f, bitmap.height/ 2.0f, 35.0f, Path.Direction.CW)
        // 裁切畫布，繪制圓形圖片
        canvas.clipPath(path)
        val matrix = Matrix()
        canvas.drawBitmap(bitmap, matrix, paint)
        canvas.restore()

        canvas.save()
        // 位移畫布
        canvas.translate(100.0f, 100.0f)
        // 旋轉畫布
        canvas.rotate(45.0f)
        canvas.drawBitmap(bitmap, matrix, paint)
        canvas.restore()
    }

效果圖：

多次保存和恢復

save 方法可以保存多次，restore 方法也可以恢復多次。
可以理解為 save 一次，就會將狀態信息壓入棧中；restore 一次，就會將棧頂元素取出棧。

通過例子來理解：

class CustomView(context: Context?, attrs: AttributeSet?) : View(context, attrs) {

    private val paint: Paint = Paint(Paint.ANTI_ALIAS_FLAG)
    private val borderPaint: Paint = Paint(Paint.ANTI_ALIAS_FLAG)
    private val textPaint: Paint = Paint(Paint.ANTI_ALIAS_FLAG)

    init {
        paint.color = Color.BLUE

        borderPaint.color = Color.RED
        borderPaint.style = Paint.Style.STROKE
        borderPaint.strokeWidth = 1f

        textPaint.color = Color.RED
        textPaint.textSize = 30f
    }

    override fun onDraw(canvas: Canvas) {
        super.onDraw(canvas)

        // 1
        canvas.drawText("1", 110f, 30f, textPaint)
        canvas.drawRect(0f, 0f, 100f, 100f, borderPaint)
        canvas.drawRect(0f, 0f, 50f, 50f, paint)

        // 保存 1 的狀態
        canvas.save()

        // 2
        canvas.translate(100f, 100f)
        canvas.drawText("2", 110f, 30f, textPaint)
        canvas.drawRect(0f, 0f, 100f, 100f, borderPaint)
        canvas.drawRect(0f, 0f, 50f, 50f, paint)

        // 保存 2 的狀態
        canvas.save()

        // 3
        canvas.translate(100f, 100f)
        canvas.drawText("3", 110f, 30f, textPaint)
        canvas.drawRect(0f, 0f, 100f, 100f, borderPaint)
        canvas.drawRect(0f, 0f, 50f, 50f, paint)

        // 保存 3 的狀態
        canvas.save()

        // 4
        canvas.translate(100f, 100f)
        canvas.drawText("4", 110f, 30f, textPaint)
        canvas.drawRect(0f, 0f, 100f, 100f, borderPaint)
        canvas.drawRect(0f, 0f, 50f, 50f, paint)
    }
}

例子中 save 了三次狀態，每次 save 完之后，會將畫布下移和右移 100 px。運行效果如下：

這時候，棧中有編號為 1，2，3 的三個狀態。
下面我們依次恢復狀態。

restore 一次，popup 出棧頂的編號為 3 的狀態，所以繪制的綠色正方形在 3 的區域。

        paint.color = Color.GREEN

        // 恢復到 3 的狀態
        canvas.restore()
        canvas.drawRect(50f, 50f, 100f, 100f, paint)

再 restore 一次，popup 出棧頂的編號為 2 的狀態，所以繪制的綠色正方形在 2 的區域。

        // 恢復到 2 的狀態
        canvas.restore()
        canvas.drawRect(50f, 50f, 100f, 100f, paint)

再 restore 一次，popup 出棧頂的編號為 1 的狀態，所以繪制的綠色正方形在 1 的區域。這時棧就空了。

        // 恢復到 1 的狀態
        canvas.restore()
        canvas.drawRect(50f, 50f, 100f, 100f, paint)

上面分三次依次恢復到原始狀態 1。

如果想恢復到指定狀態也是可以的，可以用 restoreToCount 方法，參數就是想恢復到的狀態的編號。
如果指定的狀態不在棧頂，會清空掉指定狀態上面的所有元素。

下面演示直接恢復到原始狀態

        paint.color = Color.GREEN

        // 直接恢復到 1 的狀態
        canvas.restoreToCount(1)
        canvas.drawRect(50f, 50f, 100f, 100f, paint)