CanvasContext.clip

收藏

我的收藏

注意：该接口已停止维护，建议使用 Canvas 组件 V2

基础库 1.0.0 开始支持本方法，这是一个同步方法。

从原始画布中剪切任意形状和尺寸。一旦剪切了某个区域，则所有之后的绘图都会被限制在被剪切的区域内（即不能访问画布上的其他区域）。可以在使用 CanvasContext.clip 方法前通过使用 CanvasContext.save 方法对当前画布区域进行保存，并在以后的任意时间通过 CanvasContext.restore 方法对其进行恢复。

语法

CanvasContext.clip()

参数说明

无

返回值

无

扫码体验

代码示例

开发者工具中预览

<!-- index.ttml -->
<canvas canvas-id="myCanvas"></canvas>

// index.js
Page({
  onReady() {
    const canvasCtx = tt.createCanvasContext("myCanvas");
    canvasCtx.save();
    canvasCtx.beginPath();
    canvasCtx.rect(50, 0, 240, 120);
    canvasCtx.stroke();
    canvasCtx.clip();
    canvasCtx.drawImage(
      "https://s3.pstatp.com/toutiao/static/img/logo.271e845.png",
      50,
      0
    );
    canvasCtx.restore();
    canvasCtx.draw();
  },
});

Bug & Tip

• Tip：本 API 仅适用于 <canvas> 组件 V1。