目录

OffscreenCanvasRenderingContext2D

OffscreenCanvasRenderingContext2D绘图上下文,通过OffscreenCanvas.getContext('2d')获取。

OffscreenCanvasRenderingContext2D继承自CanvasRenderingContext2D,支持全部2D绘图属性和方法。与CanvasRenderingContext2D的核心差异:

属性:

名称 类型 默认值 描述
direction string 'ltr'

在绘制文本时,描述当前文本方向。

合法值:

- 'ltr':文字方向为从左到右;

- 'rtl':文字方向为从右到左;

- 'inherit':文字方向从相应的canvas元素或Document继承。

filter string - 提供模糊、灰度等过滤效果。
fillStyle string|CanvasGradient|CanvasPattern '#000000' 指定形状内部的颜色、渐变或图案。
font string '10px sans-serif' 指定绘制文字所使用的字体属性,包括字体粗细、大小和字体风格(offCtx.font = 'bold 48px serif')。
globalAlpha number 1 全局画笔透明度。范围:0-1,0表示完全透明,1表示完全不透明。
lineCap string 'butt'

线条的末端样式。

合法值:

- 'butt':线条末端呈方形。

- 'round':线条末端呈圆形。

- 'square':线条末端呈正方形。

lineDashOffset number 0 虚线偏移量。
lineJoin string 'miter'

线条的交点样式。

合法值:

- 'bevel':斜角。

- 'round':圆角。

- 'miter':尖角。

lineWidth number 1 线条的宽度。
miterLimit number 10 最大斜接长度。
shadowBlur number 0 阴影的模糊级别。
shadowColor string rgba(0,0,0,0) 阴影的颜色。
shadowOffsetX number 0 阴影相对于形状在水平方向的偏移。
shadowOffsetY number 0 阴影相对于形状在竖直方向的偏移。
strokeStyle string|CanvasGradient|CanvasPattern '#000000' 描边颜色。
textAlign string 'start'

文本对齐方式。

合法值:

- 'left':文本左对齐;

- 'right':文本右对齐;

- 'center':文本居中对齐;

- 'start':文本对齐界线开始的地方;

- 'end':文本对齐界线结束的地方。

textBaseline string 'alphabetic'

绘制文本时使用的文本基线。

合法值:

- 'top':文本基线在文本块的顶部;

- 'hanging':文本基线是悬挂基线;

- 'middle':文本基线在文本块的中间;

- 'alphabetic':文本基线是标准的字母基线;

- 'ideographic':文字基线是表意字基线;

- 'bottom':文本基线在文本块的底部。

imageSmoothingEnabled boolean true 图片是否平滑。
imageSmoothingQuality string 'low'

图像在缩放时的平滑质量。

合法值:

- 'low':低质量;

- 'medium':中等质量;

- 'high':高质量。

globalCompositeOperation string 'source-over'

在绘制新形状时应用的合成操作的类型。

目前支持的操作如下:

- 'source-over':在现有画布上绘制新图形;

- 'source-atop':只在与现有画布内容重叠的地方绘制新图形;

- 'source-in':仅在新形状和目标画布重叠的地方绘制新形状;

- 'source-out':仅保留现有画布内容和新形状不重叠的部分;

- 'destination-over':在现有画布内容的后面绘制新的图形;

- 'destination-atop':现有画布仅在新形状重叠的区域保留,新形状会在画布内容之后绘制;

- 'destination-in':现有画布内容会在新形状和现有画布内容重叠的区域保留,其他所有内容都将变为透明;

- 'destination-out':现有内容会在不与新形状重叠的区域保留;

- 'lighter':在两个形状重叠的区域,颜色通过将颜色值相加来确定;

- 'copy':仅显示新形状;

- 'xor':在两个形状重叠的区域,形状会变为透明,在其他所有区域正常绘制。

OffscreenCanvasRenderingContext2D.arc

OffscreenCanvasRenderingContext2D.arc(number x, number y, number r, number sAngle, number eAngle, boolean counterclockwise)

将一个圆弧添加到当前子路径中。

起始版本: 2.0.6

参数:

参数 类型 默认值 必填 描述
x number - 是 圆心的x坐标。
y number - 是 圆心的y坐标。
r number - 是 圆的半径。
sAngle number - 是 起始弧度,单位弧度(在3点钟方向)。
eAngle number - 是 终止弧度。
counterclockwise boolean false 否 弧度的方向是否是逆时针。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.arc(100, 75, 50, 0, 2 * Math.PI);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.arcTo

OffscreenCanvasRenderingContext2D.arcTo(number x1, number y1, number x2, number y2, number radius)

通过给定的控制点和半径向当前子路径添加一个圆弧。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x1 number 是 第一个控制点的x轴坐标。
y1 number 是 第一个控制点的y轴坐标。
x2 number 是 第二个控制点的x轴坐标。
y2 number 是 第二个控制点的y轴坐标。
radius number 是 圆弧的半径。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.moveTo(200, 20);
offCtx.arcTo(200, 130, 50, 20, 40);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.beginPath

OffscreenCanvasRenderingContext2D.beginPath()

开始创建一个新的路径。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
// 第一条路径
offCtx.beginPath();
offCtx.strokeStyle = 'blue';
offCtx.moveTo(20, 20);
offCtx.lineTo(200, 20);
offCtx.stroke();
// 第二条路径
offCtx.beginPath();
offCtx.strokeStyle = 'green';
offCtx.moveTo(20, 20);
offCtx.lineTo(120, 120);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.bezierCurveTo

OffscreenCanvasRenderingContext2D.bezierCurveTo(number cp1x, number cp1y, number cp2x, number cp2y, number x, number y)

绘制三次贝塞尔曲线。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
cp1x number 是 第一个贝塞尔控制点的x坐标。
cp1y number 是 第一个贝塞尔控制点的y坐标。
cp2x number 是 第二个贝塞尔控制点的x坐标。
cp2y number 是 第二个贝塞尔控制点的y坐标。
x number 是 结束点的x坐标。
y number 是 结束点的y坐标。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.moveTo(30, 30);
offCtx.bezierCurveTo(120, 160, 180, 10, 220, 140);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.clearRect

OffscreenCanvasRenderingContext2D.clearRect(number x, number y, number width, number height)

擦除画布上一块矩形区域,使区域变透明。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 矩形路径左上角的横坐标。
y number 是 矩形路径左上角的纵坐标。
width number 是 矩形路径的宽度。
height number 是 矩形路径的高度。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'red';
offCtx.fillRect(0, 0, 200, 100);
offCtx.clearRect(10, 10, 75, 75);

OffscreenCanvasRenderingContext2D.clip

OffscreenCanvasRenderingContext2D.clip(Path2D path, string fillRule)

使用当前路径或指定的Path2D路径剪切画布。

起始版本: 2.0.6

参数:

参数 类型 默认值 必填 描述
path Path2D - 否 指定裁剪的路径。默认值:使用当前路径裁剪画布。
fillRule string 'nonzero' 否

填充规则,用于判断一个点是否在路径内。

合法值:

- 'nonzero':非零环绕规则;

- 'evenodd':奇偶环绕规则。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
// 创建裁剪路径
offCtx.beginPath();
offCtx.rect(80, 10, 20, 130);
offCtx.rect(40, 50, 100, 50);
offCtx.clip('nonzero');
// 绘制被裁剪的内容
offCtx.fillStyle = 'blue';
offCtx.fillRect(0, 0, 300, 150);

OffscreenCanvasRenderingContext2D.closePath

OffscreenCanvasRenderingContext2D.closePath()

关闭一个路径,会连接起点和终点。如果关闭路径后没有调用fill或者stroke并开启了新的路径,那么之前的路径将不会被渲染。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.moveTo(20, 140);
offCtx.lineTo(120, 10);
offCtx.lineTo(220, 140);
offCtx.closePath();
offCtx.stroke();

OffscreenCanvasRenderingContext2D.createConicGradient

OffscreenCanvasRenderingContext2D.createConicGradient(number startAngle, number x, number y): CanvasGradient

围绕指定坐标点创建渐变。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
startAngle number 是 渐变开始的角度,单位:弧度。角度从中心向右水平线开始,并顺时针旋转。
x number 是 渐变中心的x轴坐标。
y number 是 渐变中心的y轴坐标。

返回值:

返回CanvasGradient对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
const gradient = offCtx.createConicGradient(0, 100, 100);
gradient.addColorStop(0, 'red');
gradient.addColorStop(0.25, 'orange');
gradient.addColorStop(0.5, 'yellow');
gradient.addColorStop(0.75, 'green');
gradient.addColorStop(1, 'blue');
offCtx.fillStyle = gradient;
offCtx.fillRect(20, 10, 150, 130);

OffscreenCanvasRenderingContext2D.createLinearGradient

OffscreenCanvasRenderingContext2D.createLinearGradient(number x0, number y0, number x1, number y1): CanvasGradient

创建一个线性的渐变色。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x0 number 是 起点的x轴坐标。
y0 number 是 起点的y轴坐标。
x1 number 是 终点的x轴坐标。
y1 number 是 终点的y轴坐标。

返回值:

返回CanvasGradient对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
const gradient = offCtx.createLinearGradient(20, 0, 220, 0);
gradient.addColorStop(0, 'green');
gradient.addColorStop(0.5, 'cyan');
gradient.addColorStop(1, 'green');
offCtx.fillStyle = gradient;
offCtx.fillRect(20, 20, 200, 100);

OffscreenCanvasRenderingContext2D.createRadialGradient

OffscreenCanvasRenderingContext2D.createRadialGradient(number x0, number y0, number r0, number x1, number y1, number r1): CanvasGradient

创建一个放射性的渐变色。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x0 number 是 开始圆形的x轴坐标。
y0 number 是 开始圆形的y轴坐标。
r0 number 是 开始圆形的半径。
x1 number 是 结束圆形的x轴坐标。
y1 number 是 结束圆形的y轴坐标。
r1 number 是 结束圆形的半径。

返回值:

返回CanvasGradient对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
const gradient = offCtx.createRadialGradient(100, 80, 30, 100, 80, 60);
gradient.addColorStop(0, 'pink');
gradient.addColorStop(0.9, 'white');
gradient.addColorStop(1, 'green');
offCtx.fillStyle = gradient;
offCtx.fillRect(20, 10, 150, 130);

OffscreenCanvasRenderingContext2D.createPattern

OffscreenCanvasRenderingContext2D.createPattern(Image image, string repetition): CanvasPattern

使用指定的图像或重复创建图案。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
image Image 是 元图像,即图案的原始图像源。
repetition string 是

如何重复图像。

合法值:

- 'repeat':两个方向都重复;

- 'repeat-x':仅水平方向重复;

- 'repeat-y':仅垂直方向重复;

- 'no-repeat':两个方向都不重复。

返回值:

CanvasPattern图案对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
// 创建Image对象需通过可见Canvas
has.createSelectorQuery().select('#myCanvas')
  .node((res) => {
    const canvas = res.node;
    const img = canvas.createImage();
    img.src = 'https://www.example.com/xxxx.png'; // 此处仅为样例,请开发者更换为可用图片资源地址
    img.onload = () => {
      const pattern = offCtx.createPattern(img, 'repeat');
      offCtx.fillStyle = pattern;
      offCtx.fillRect(0, 0, 200, 150);
    };
    img.onerror = (err) => {
      console.error('createImage error', err);
    };
  })
  .exec();

OffscreenCanvasRenderingContext2D.drawImage

OffscreenCanvasRenderingContext2D.drawImage(Image image, number sx, number sy, number sWidth, number sHeight, number dx, number dy, number dWidth, number dHeight)

绘制图片到画布。支持将另一个OffscreenCanvas实例作为图像源,实现离屏画布互操作。

起始版本: 2.0.6

参数:

当前支持三种入参方式,请开发者根据实际情况选择。

参数 类型 默认值 必填 描述
image Image|Canvas|OffscreenCanvas - 是 要绘制的内容。支持Image对象、可见Canvas实例和OffscreenCanvas实例。
sx number 0 否 需要绘制到画布中源图像的矩形选择框的左上角x坐标。
sy number 0 否 需要绘制到画布中源图像的矩形选择框的左上角y坐标。
sWidth number - 否 需要绘制到画布中源图像的矩形选择框的宽度。默认值:与源图像宽度保持一致。
sHeight number - 否 需要绘制到画布中源图像的矩形选择框的高度。默认值:与源图像高度保持一致。
dx number - 是 图像的左上角在目标canvas上x轴的位置。
dy number - 是 图像的左上角在目标canvas上y轴的位置。
dWidth number - 否 在目标画布上绘制图像的宽度,允许对绘制的图像进行缩放。默认值:与源图像宽度保持一致。
dHeight number - 否 在目标画布上绘制图像的高度,允许对绘制的图像进行缩放。默认值:与源图像高度保持一致。

示例:

// 创建源离屏画布,绘制红色矩形
const srcOffscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const srcCtx = srcOffscreenCanvas.getContext('2d');
srcCtx.fillStyle = 'red';
srcCtx.fillRect(0, 0, 100, 100);

// 创建目标离屏画布,通过drawImage将源离屏画布的内容复制过来
const dstOffscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const dstCtx = dstOffscreenCanvas.getContext('2d');
dstCtx.drawImage(srcOffscreenCanvas, 0, 0);

// 将目标离屏画布绘制到可见画布
has.createSelectorQuery().select('#myCanvas')
  .node((res) => {
    const canvas = res.node;
    const ctx = canvas.getContext('2d');
    ctx.drawImage(dstOffscreenCanvas, 0, 0);
  })
  .exec();

OffscreenCanvasRenderingContext2D.ellipse

OffscreenCanvasRenderingContext2D.ellipse(number x, number y, number radiusX, number radiusY, number rotation, number startAngle, number endAngle, boolean counterclockwise)

添加一个椭圆弧到当前子路径。

起始版本: 2.0.6

参数:

参数 类型 默认值 必填 描述
x number - 是 椭圆圆心的x轴坐标。
y number - 是 椭圆圆心的y轴坐标。
radiusX number - 是 椭圆长轴的半径。
radiusY number - 是 椭圆短轴的半径。
rotation number - 是 椭圆顺时针旋转的角度,单位:弧度。
startAngle number - 是 椭圆弧起始点的离心角角度,从正x轴顺时针测量并以弧度表示。
endAngle number - 是 椭圆弧结束点的离心角角度,从正x轴顺时针测量并以弧度表示。
counterclockwise boolean false 否 是否沿逆时针方向绘制椭圆。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.ellipse(150, 75, 50, 30, Math.PI * 0.25, 0, Math.PI);
offCtx.fill();

OffscreenCanvasRenderingContext2D.fill

OffscreenCanvasRenderingContext2D.fill(Path2D path, string fillRule)

填充当前路径或指定Path2D路径。

起始版本: 2.0.6

参数:

参数 类型 默认值 必填 描述
path Path2D - 否 指定填充的Path2D路径。默认值:填充当前路径。
fillRule string 'nonzero' 否

填充规则,用于判断一个点是否在填充区域内。

合法值:

- 'nonzero':非零环绕规则;

- 'evenodd':奇偶环绕规则。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.moveTo(30, 90);
offCtx.lineTo(110, 20);
offCtx.lineTo(240, 130);
offCtx.lineTo(60, 130);
offCtx.lineTo(190, 20);
offCtx.lineTo(270, 90);
offCtx.closePath();
offCtx.fillStyle = 'green';
offCtx.fill('nonzero');

OffscreenCanvasRenderingContext2D.fillRect

OffscreenCanvasRenderingContext2D.fillRect(number x, number y, number width, number height)

绘制实心矩形。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 矩形路径左上角的横坐标。
y number 是 矩形路径左上角的纵坐标。
width number 是 矩形路径的宽度。
height number 是 矩形路径的高度。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'green';
offCtx.fillRect(20, 10, 150, 100);

OffscreenCanvasRenderingContext2D.fillText

OffscreenCanvasRenderingContext2D.fillText(string text, number x, number y, number maxWidth)

在画布上绘制被填充的文本。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
text string 是 在画布上输出的文本。
x number 是 绘制文本的左上角x坐标位置。
y number 是 绘制文本的左上角y坐标位置。
maxWidth number 否 需要绘制的最大宽度。默认值:与文本实际宽度保持一致。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.font = '50px serif';
offCtx.fillText('Hello world', 50, 90);

OffscreenCanvasRenderingContext2D.getLineDash

OffscreenCanvasRenderingContext2D.getLineDash(): Array<number>

获取当前虚线样式。

起始版本: 2.0.6

返回值:

Array<number>

一组用于描述虚线的线段和间隔的数字。如 [10, 5]代表虚线样式为10像素连续线段,5像素间隔,以此重复。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.setLineDash([10, 20]);
offCtx.beginPath();
offCtx.moveTo(0, 50);
offCtx.lineTo(300, 50);
offCtx.stroke();
const lineDashArray = offCtx.getLineDash();
console.info('getLineDash is ', lineDashArray);

OffscreenCanvasRenderingContext2D.getTransform

OffscreenCanvasRenderingContext2D.getTransform(): Object

获取当前上下文设置的变换矩阵。

起始版本: 2.0.6

返回值:

返回一个DOMMatrix对象。变换矩阵的描述如下图所示:

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.setTransform(1, 0.2, 0.8, 1, 0, 0);
offCtx.fillRect(0, 0, 100, 100);
const transform = offCtx.getTransform();
console.info('getTransform is ', transform);

OffscreenCanvasRenderingContext2D.lineTo

OffscreenCanvasRenderingContext2D.lineTo(number x, number y)

添加线段到当前子路径。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 目标位置的x坐标。
y number 是 目标位置的y坐标。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.moveTo(30, 50);
offCtx.lineTo(150, 100);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.measureText

OffscreenCanvasRenderingContext2D.measureText(string text): Object

测量文本尺寸和计量信息。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
text string 是 要测量的文本的内容。

返回值:

返回Object对象。

参数 类型 描述
width number 文本方块的宽度。
height number 文本方块的高度。
actualBoundingBoxAscent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到渲染文本的矩形边界顶部的距离。
actualBoundingBoxDescent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到渲染文本的矩形边界底部的距离。
actualBoundingBoxLeft number 从OffscreenCanvasRenderingContext2D.textAlign属性确定的对齐点到文本矩形边界左侧的距离。
actualBoundingBoxRight number 平行于基线,从OffscreenCanvasRenderingContext2D.textAlign属性确定的对齐点到文本矩形边界右侧的距离。
alphabeticBaseline number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到线框的alphabetic基线的距离。
fontBoundingBoxAscent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到渲染文本的所有字体的矩形最高边界顶部的距离。
fontBoundingBoxDescent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到渲染文本的所有字体的矩形边界最底部的距离。
emHeightAscent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到线框中em方块顶部的距离。
emHeightDescent number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到线框中em方块底部的距离。
hangingBaseline number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到线框的hanging基线的距离。
ideographicBaseline number 从OffscreenCanvasRenderingContext2D.textBaseline属性标明的水平线到线框的ideographic基线的距离。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
const text = offCtx.measureText('Hello world');
console.info('text width is ', text.width);

OffscreenCanvasRenderingContext2D.moveTo

OffscreenCanvasRenderingContext2D.moveTo(number x, number y)

指定新的子路径起始位置。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 新的子路径起始位置的x轴坐标。
y number 是 新的子路径起始位置的y轴坐标。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.beginPath();
offCtx.moveTo(50, 50);
offCtx.lineTo(200, 50);
offCtx.moveTo(50, 90);
offCtx.lineTo(280, 120);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.quadraticCurveTo

OffscreenCanvasRenderingContext2D.quadraticCurveTo(number cpx, number cpy, number x, number y)

添加二次贝塞尔曲线到当前子路径。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
cpx number 是 贝塞尔控制点的x坐标。
cpy number 是 贝塞尔控制点的y坐标。
x number 是 结束点的x坐标。
y number 是 结束点的y坐标。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.moveTo(50, 20);
offCtx.quadraticCurveTo(230, 30, 50, 100);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.rect

OffscreenCanvasRenderingContext2D.rect(number x, number y, number width, number height)

添加一个矩形子路径至当前路径。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 矩形路径左上角的横坐标。
y number 是 矩形路径左上角的纵坐标。
width number 是 矩形路径的宽度。
height number 是 矩形路径的高度。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.rect(10, 20, 150, 100);
offCtx.fill();

OffscreenCanvasRenderingContext2D.roundRect

OffscreenCanvasRenderingContext2D.roundRect(number x, number y, number width, number height, number|Array<number> radii)

添加一个圆角矩形子路径至当前路径。从API版本20开始,该接口支持在元服务中使用。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 矩形路径左上角的横坐标。
y number 是 矩形路径左上角的纵坐标。
width number 是 矩形路径的宽度。
height number 是 矩形路径的高度。
radii number|Array<number> 是

圆角半径。支持number或number[],数组长度1-4。

1值:四角相同;

2值:[左上,右上];

3值:[左上,右上,右下];

4值:[左上,右上,右下,左下]。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.roundRect(10, 20, 150, 100, 20);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.reset

OffscreenCanvasRenderingContext2D.reset()

将渲染上下文重置为其默认状态。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.reset();

OffscreenCanvasRenderingContext2D.resetTransform

OffscreenCanvasRenderingContext2D.resetTransform()

重置画布的变换矩阵为单位矩阵。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.rotate((45 * Math.PI) / 180);
offCtx.fillRect(60, 0, 100, 30);
offCtx.resetTransform();
offCtx.fillRect(60, 0, 100, 30);

OffscreenCanvasRenderingContext2D.restore

OffscreenCanvasRenderingContext2D.restore()

恢复之前保存的绘图上下文。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'red';
offCtx.save();
offCtx.fillStyle = 'green';
offCtx.fillRect(10, 10, 100, 100);
offCtx.restore();
offCtx.fillRect(150, 40, 100, 100);

OffscreenCanvasRenderingContext2D.rotate

OffscreenCanvasRenderingContext2D.rotate(number angle)

旋转当前坐标轴。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
angle number 是 旋转的弧度。可以使用:旋转角度 * Math.PI / 180计算。旋转角度为正数将顺时针旋转,为负数将逆时针旋转。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'gray';
offCtx.fillRect(80, 60, 140, 30);
offCtx.translate(150, 75);
offCtx.rotate(Math.PI / 2);
offCtx.translate(-150, -75);
offCtx.fillStyle = 'red';
offCtx.fillRect(80, 60, 140, 30);

OffscreenCanvasRenderingContext2D.save

OffscreenCanvasRenderingContext2D.save()

保存当前绘图上下文。

起始版本: 2.0.6

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'red';
offCtx.save();
offCtx.fillStyle = 'green';
offCtx.fillRect(10, 10, 100, 100);
offCtx.restore();
offCtx.fillRect(150, 40, 100, 100);

OffscreenCanvasRenderingContext2D.scale

OffscreenCanvasRenderingContext2D.scale(number scaleWidth, number scaleHeight)

根据水平和垂直方向,为canvas画布添加缩放变换。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
scaleWidth number 是 水平方向的缩放倍数。
scaleHeight number 是 垂直方向的缩放倍数。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.scale(9, 3);
offCtx.fillStyle = 'red';
offCtx.fillRect(10, 10, 8, 20);
offCtx.setTransform(1, 0, 0, 1, 0, 0);
offCtx.fillStyle = 'gray';
offCtx.fillRect(10, 10, 8, 20);

OffscreenCanvasRenderingContext2D.setLineDash

OffscreenCanvasRenderingContext2D.setLineDash(Array<number> pattern)

设置描边的虚线样式。若要设置为实线,可传入空数组。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
pattern Array<number> 是 一组用于描述虚线交替绘制线段和间距长度的数字。奇数长度的数组会被复制拼接成偶数长度的数组再处理,例如,[1, 2, 3] 会被当做 [1, 2, 3, 1, 2, 3] 处理。如果传入空数组,则线条将重置为实线。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.beginPath();
offCtx.setLineDash([5, 15]);
offCtx.moveTo(0, 50);
offCtx.lineTo(300, 50);
offCtx.stroke();
offCtx.beginPath();
offCtx.setLineDash([]);
offCtx.moveTo(0, 100);
offCtx.lineTo(300, 100);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.setTransform

OffscreenCanvasRenderingContext2D.setTransform(number a, number b, number c, number d, number e, number f)

使用矩阵重新设置(覆盖)当前变换。变换矩阵的描述如下图所示:

起始版本: 2.0.6

参数:

参数 类型 必填 描述
a number 是 水平缩放(矩阵的第一行第一列的单元格)。
b number 是 垂直倾斜(矩阵的第二行第一列的单元格)。
c number 是 水平倾斜(矩阵的第一行第二列的单元格)。
d number 是 垂直缩放(矩阵的第二行第二列的单元格)。
e number 是 水平移动(矩阵的第一行第三列的单元格)。
f number 是 垂直移动(矩阵的第二行第三列的单元格)。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.setTransform(1, 0.2, 0.8, 1, 0, 0);
offCtx.fillRect(0, 0, 100, 100);

OffscreenCanvasRenderingContext2D.stroke

OffscreenCanvasRenderingContext2D.stroke(Path2D path)

为当前路径或指定Path2D路径中所有子路径绘制描边。

起始版本: 2.0.6

参数:

参数 类型 默认值 必填 描述
path Path2D - 否 指定描边的Path2D路径。默认值:填充当前路径。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.rect(10, 10, 150, 100);
offCtx.stroke();

OffscreenCanvasRenderingContext2D.strokeRect

OffscreenCanvasRenderingContext2D.strokeRect(number x, number y, number width, number height)

绘制只有描边的空心矩形。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 矩形路径左上角的横坐标。
y number 是 矩形路径左上角的纵坐标。
width number 是 矩形路径的宽度。
height number 是 矩形路径的高度。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.strokeStyle = 'green';
offCtx.strokeRect(20, 10, 160, 100);

OffscreenCanvasRenderingContext2D.strokeText

OffscreenCanvasRenderingContext2D.strokeText(string text, number x, number y, number maxWidth)

绘制只有描边的空心文本。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
text string 是 要绘制的文本。
x number 是 文本起始点的x轴坐标。
y number 是 文本起始点的y轴坐标。
maxWidth number 否 需要绘制的最大宽度。默认值:与文本实际宽度保持一致。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.font = '50px serif';
offCtx.strokeText("Hello world", 50, 90);

OffscreenCanvasRenderingContext2D.transform

OffscreenCanvasRenderingContext2D.transform(number scaleX, number skewX, number skewY, number scaleY, number translateX, number translateY)

叠加变换矩阵。变换矩阵的描述如下图所示:

起始版本: 2.0.6

参数:

参数 类型 必填 描述
scaleX number 是 水平缩放。
skewX number 是 水平倾斜。
skewY number 是 垂直倾斜。
scaleY number 是 垂直缩放。
translateX number 是 水平移动。
translateY number 是 垂直移动。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.strokeStyle = 'black';
offCtx.strokeRect(0, 0, 100, 100);
offCtx.transform(1, 0.2, 0.5, 1, 0, 0);
offCtx.strokeStyle = 'red';
offCtx.strokeRect(0, 0, 100, 100);
offCtx.transform(1, 0.2, 0.5, 1, 0, 0);
offCtx.strokeStyle = 'green';
offCtx.strokeRect(0, 0, 100, 100);

OffscreenCanvasRenderingContext2D.translate

OffscreenCanvasRenderingContext2D.translate(number x, number y)

平移当前坐标系。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
x number 是 水平平移量。正值向右移动,负值向左移动。
y number 是 垂直平移量。正值向下移动,负值向上移动。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.lineWidth = 1;
offCtx.strokeRect(20, 10, 100, 80);
offCtx.translate(30, 30);
offCtx.strokeRect(20, 10, 100, 80);

OffscreenCanvasRenderingContext2D.createImageData

OffscreenCanvasRenderingContext2D.createImageData(number width, number height): ImageData

创建一个指定宽高的ImageData对象。

起始版本: 2.0.6

参数:

当前支持两种入参方式,请开发者根据实际情况选择。

参数 类型 必填 描述
width number 是 新ImageData对象的宽度,单位:px。
height number 是 新ImageData对象的高度,单位:px。
imageData ImageData 是 待拷贝的ImageData。

返回值:

返回ImageData对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
const imageData = offCtx.createImageData(100, 100);
console.info('createImageData, width:', imageData.width);
console.info('createImageData, height:', imageData.height);
console.info('createImageData, data length:', imageData.data.length);

OffscreenCanvasRenderingContext2D.getImageData

OffscreenCanvasRenderingContext2D.getImageData(number sx, number sy, number sw, number sh): ImageData

获取画布上指定矩形区域的ImageData对象。

起始版本: 2.0.6

参数:

参数 类型 必填 描述
sx number 是 要提取ImageData的矩形左上角的x轴坐标。
sy number 是 要提取ImageData的矩形左上角的y轴坐标。
sw number 是 要提取ImageData的矩形的宽度,取绝对值,单位:px。
sh number 是 要提取ImageData的矩形的高度,取绝对值,单位:px。

返回值:

返回ImageData对象。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'red';
offCtx.fillRect(0, 0, 100, 100);
const imageData = offCtx.getImageData(0, 0, 100, 100);
console.info('getImageData, width:', imageData.width);
console.info('getImageData, height:', imageData.height);
console.info('getImageData, data length:', imageData.data.length);

OffscreenCanvasRenderingContext2D.putImageData

OffscreenCanvasRenderingContext2D.putImageData(ImageData imageData, number dx, number dy, number dirtyX, number dirtyY, number dirtyWidth, number dirtyHeight)

将ImageData对象绘制到画布上。

起始版本: 2.0.6

参数:

当前支持两种入参方式,请开发者根据实际情况选择。

参数 类型 默认值 必填 描述
imageData ImageData - 是 待绘制的ImageData对象。
dx number - 是 图像数据的水平位置。
dy number - 是 图像数据的垂直位置。
dirtyX number 0 否 提取图像数据的左上角的水平位置。
dirtyY number 0 否 提取图像数据的左上角的垂直位置。
dirtyWidth number - 否 要绘制的矩形的宽度。单位:px。默认值:与图像数据的宽度保持一致。
dirtyHeight number - 否 要绘制的矩形的高度。单位:px。默认值:与图像数据的高度保持一致。

示例:

const offscreenCanvas = has.createOffscreenCanvas({
  type: '2d',
  width: 300,
  height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.fillStyle = 'red';
offCtx.fillRect(0, 0, 100, 100);
const imageData = offCtx.getImageData(0, 0, 100, 100);
offCtx.putImageData(imageData, 50, 50);