• save：保存畫布的狀態(tài)
• restore：將畫布保存到之前保存的狀態(tài)

這有什么用呢？
當(dāng)調(diào)用 save 保存了畫布的狀態(tài)之后，就可以對畫布為所欲為了（調(diào)用 Canvas 的平移、放縮、旋轉(zhuǎn)、錯切、裁剪等操作），反正可以調(diào)用 restore 恢復(fù)狀態(tài)不是嗎？

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)
        // 旋轉(zhuǎn)畫布
        canvas.rotate(45.0f)
        canvas.drawBitmap(bitmap, matrix, paint)
        canvas.restore()
    }

效果圖：

多次保存和恢復(fù)

save 方法可以保存多次，restore 方法也可以恢復(fù)多次。
可以理解為 save 一次，就會將狀態(tài)信息壓入棧中；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 的狀態(tài)
        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 的狀態(tài)
        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 的狀態(tài)
        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 了三次狀態(tài)，每次 save 完之后，會將畫布下移和右移 100 px。運行效果如下：

這時候，棧中有編號為 1，2，3 的三個狀態(tài)。
下面我們依次恢復(fù)狀態(tài)。

restore 一次，popup 出棧頂?shù)木幪枮?3 的狀態(tài)，所以繪制的綠色正方形在 3 的區(qū)域。

        paint.color = Color.GREEN

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

再 restore 一次，popup 出棧頂?shù)木幪枮?2 的狀態(tài)，所以繪制的綠色正方形在 2 的區(qū)域。

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

再 restore 一次，popup 出棧頂?shù)木幪枮?1 的狀態(tài)，所以繪制的綠色正方形在 1 的區(qū)域。這時棧就空了。

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

上面分三次依次恢復(fù)到原始狀態(tài) 1。

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

下面演示直接恢復(fù)到原始狀態(tài)

        paint.color = Color.GREEN

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