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(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(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()
开始创建一个新的路径。
起始版本: 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(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(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(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()
关闭一个路径,会连接起点和终点。如果关闭路径后没有调用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(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(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(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(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(Image image, number sx, number sy, number sWidth, number sHeight, number dx, number dy, number dWidth, number dHeight)
绘制图片到画布。支持将另一个OffscreenCanvas实例作为图像源,实现离屏画布互操作。
起始版本: 2.0.6
参数:
当前支持三种入参方式,请开发者根据实际情况选择。
drawImage(image, dx, dy, dWidth, dHeight):将图像绘制到目标画布的指定位置,并缩放到指定宽高。
drawImage(image, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight):从源图像裁剪指定区域,缩放后绘制到目标画布的指定位置。
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| 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(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(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(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(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(): 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(): 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(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(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(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(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(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(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()
将渲染上下文重置为其默认状态。
起始版本: 2.0.6
示例:
const offscreenCanvas = has.createOffscreenCanvas({
type: '2d',
width: 300,
height: 150
});
const offCtx = offscreenCanvas.getContext('2d');
offCtx.reset(); 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()
恢复之前保存的绘图上下文。
起始版本: 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(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()
保存当前绘图上下文。
起始版本: 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(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(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(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(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(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(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(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(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(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(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(ImageData imageData, number dx, number dy, number dirtyX, number dirtyY, number dirtyWidth, number dirtyHeight)
将ImageData对象绘制到画布上。
起始版本: 2.0.6
参数:
当前支持两种入参方式,请开发者根据实际情况选择。
putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight):将ImageData对象的指定矩形区域绘制到画布的指定位置。
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| 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);