canvas组件的绘图上下文。
属性:
| 参数 | 类型 | 描述 |
|---|---|---|
| strokeStyle | string|CanvasGradient | 边框颜色。 用法同CanvasContext.setStrokeStyle。 起始版本: 1.0.15 |
| shadowOffsetX | number | 阴影相对于形状在水平方向的偏移。 起始版本: 1.0.15 |
| shadowOffsetY | number | 阴影相对于形状在竖直方向的偏移。 起始版本: 1.0.15 |
| shadowColor | string | 阴影的颜色。 起始版本: 1.0.15 |
| shadowBlur | number | 阴影的模糊级别。 起始版本: 1.0.15 |
| lineWidth | number | 线条的宽度。 用法同CanvasContext.setLineWidth。 起始版本: 1.0.15 |
| lineCap | string | 线条的端点样式。 合法值: - 'butt':向线条的每个末端添加平直的边缘。 - 'round':向线条的每个末端添加圆形线帽。 - 'square':向线条的每个末端添加正方形线帽。 起始版本: 1.0.15 |
| lineJoin | string | 线条的交点样式。 合法值: - 'bevel':斜角。 - 'round':圆角。 - 'miter':尖角。 起始版本: 1.0.15 |
| miterLimit | number | 最大斜接长度。 用法同CanvasContext.setMiterLimit。 起始版本: 1.0.15 |
| lineDashOffset | number | 虚线偏移量,初始值为0。 起始版本: 1.0.15 |
| globalCompositeOperation | string | 在绘制新形状时应用的合成操作的类型。目前支持的操作有如下: - 'source-over', - 'source-atop', - 'source-in', - 'source-out', - 'destination-over', - 'destination-atop', - 'destination-in', - 'destination-out', - 'lighter', - 'copy', - 'xor'。 起始版本: 1.0.15 |
| globalAlpha | number | 全局画笔透明度。范围0-1,0表示完全透明,1表示完全不透明。 起始版本: 1.0.15 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.lineWidth = 10;
ctx.arc(100, 75, 50, 0, 2 * Math.PI);
ctx.draw(); CanvasContext.arc(number x, number y, number r, number sAngle, number eAngle, boolean counterclockwise)
创建一条弧线。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 圆心的x坐标。 |
| y | number | 是 | 圆心的y坐标。 |
| r | number | 是 | 圆的半径。 |
| sAngle | number | 是 | 起始弧度,单位弧度(在3点钟方向)。 |
| eAngle | number | 是 | 终止弧度。 |
| counterclockwise | boolean | 否 | 弧度的方向是否是逆时针。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.arc(100, 75, 50, 0, 2 * Math.PI);
ctx.setFillStyle('#EEEEEE');
ctx.fill();
ctx.draw(); CanvasContext.arcTo(number x1, number y1, number x2, number y2, number radius)
根据控制点和半径绘制圆弧路径。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x1 | number | 是 | 第一个控制点的x轴坐标。 |
| y1 | number | 是 | 第一个控制点的y轴坐标。 |
| x2 | number | 是 | 第二个控制点的x轴坐标。 |
| y2 | number | 是 | 第二个控制点的y轴坐标。 |
| radius | number | 是 | 圆弧的半径。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(20, 20);
ctx.lineTo(100, 20);
ctx.arcTo(150, 20, 150, 70, 50);
ctx.lineTo(150, 120);
ctx.stroke();
ctx.draw(); CanvasContext.beginPath()
开始创建一个路径。需要调用fill或者stroke才会使用路径进行填充或描边。
起始版本: 1.0.0
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.setStrokeStyle('#ff0000');
ctx.moveTo(0, 75);
ctx.lineTo(250, 75);
ctx.stroke();
ctx.beginPath();
ctx.setStrokeStyle('#0000ff');
ctx.moveTo(50, 0);
ctx.lineTo(150, 130);
ctx.draw(); CanvasContext.bezierCurveTo(number cp1x, number cp1y, number cp2x, number cp2y, number x, number y)
创建三次方贝塞尔曲线路径。曲线的起始点为路径中前一个点。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| cp1x | number | 是 | 第一个贝塞尔控制点的x坐标。 |
| cp1y | number | 是 | 第一个贝塞尔控制点的y坐标。 |
| cp2x | number | 是 | 第二个贝塞尔控制点的x坐标。 |
| cp2y | number | 是 | 第二个贝塞尔控制点的y坐标。 |
| x | number | 是 | 结束点的x坐标。 |
| y | number | 是 | 结束点的y坐标。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(20, 20);
ctx.bezierCurveTo(20, 100, 200, 100, 200, 20);
ctx.stroke();
ctx.draw(); CanvasContext.clip()
从原始画布中剪切任意形状和尺寸。
一旦剪切了某个区域,则所有之后的绘图都会被限制在被剪切的区域内(不能访问画布上的其他区域)。
可以在使用clip方法前通过使用save方法对当前画布区域进行保存,并在以后的任意时间通过restore方法对其进行恢复。
起始版本: 1.0.0
示例:
使用draw方法绘制结果。
切割图片:
const ctx = has.createCanvasContext('myCanvas');
has.downloadFile({
url: 'https://www.example.com/xxx.png', // 此处仅为样例,请开发者更换为可用图片资源地址
success: (res) => {
ctx.save();
ctx.beginPath();
ctx.arc(50, 50, 25, 0, 2 * Math.PI);
ctx.clip();
ctx.drawImage(res.tempFilePath, 25, 25);
ctx.restore();
ctx.draw();
}
}); 切割图形:
const ctx = has.createCanvasContext('myCanvas');
ctx.arc(50, 50, 50, 0, 2 * Math.PI);
ctx.save();
ctx.clip();
ctx.fillRect(0, 0, 20, 200);
ctx.restore();
ctx.draw(); CanvasContext.closePath()
关闭一个路径。会连接起点和终点。如果关闭路径后没有调用fill或者stroke并开启了新的路径,那么之前的路径将不会被渲染。
起始版本: 1.0.0
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(100, 10);
ctx.lineTo(100, 100);
ctx.closePath();
ctx.stroke();
ctx.draw(); CanvasContext.createCircularGradient(number x, number y, number r): CanvasGradient
创建一个圆形的渐变颜色。起点在圆心,终点在圆环。
返回的CanvasGradient对象需要使用CanvasGradient.addColorStop()来指定渐变点,至少要两个。
起始版本: 1.0.4
参数:
参数x、y支持传入空值,参数r必须填入。当x、y不传入时,样例如下:
CanvasContext.createCircularGradient(undefined, undefined, 50)
此时,传参效果等同于:
CanvasContext.createCircularGradient(0, 0, 50)
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| x | number | 0 | 否 | 圆心的x坐标。 |
| y | number | 0 | 否 | 圆心的y坐标。 |
| r | number | - | 是 | 圆的半径。 |
返回值:
返回CanvasGradient对象。
示例:
const ctx = has.createCanvasContext('myCanvas');
const grd = ctx.createCircularGradient(75, 50, 50);
grd.addColorStop(0, 'red');
grd.addColorStop(1, 'black');
ctx.setFillStyle(grd);
ctx.fillRect(10, 10, 150, 80);
ctx.draw(); CanvasContext.createLinearGradient(number x0, number y0, number x1, number y1): CanvasGradient
创建一个线性的渐变颜色。返回的CanvasGradient对象需要使用CanvasGradient.addColorStop()来指定渐变点,至少要两个。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| x0 | number | 0 | 否 | 起点的x坐标。 |
| y0 | number | 0 | 否 | 起点的y坐标。 |
| x1 | number | 0 | 否 | 终点的x坐标。 |
| y1 | number | 0 | 否 | 终点的y坐标。 |
返回值:
返回CanvasGradient对象。
示例:
const ctx = has.createCanvasContext('myCanvas');
const grd = ctx.createLinearGradient(0, 0, 200, 0);
grd.addColorStop(0, 'red');
grd.addColorStop(1, 'green');
ctx.setFillStyle(grd);
ctx.fillRect(10, 10, 150, 80);
ctx.draw(); CanvasContext.draw(boolean reserve, function callback)
将之前在绘图上下文中的描述(路径、变形、样式)画到canvas中。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| reserve | boolean | false | 否 | 本次绘制是否接着上一次绘制。 reserve参数为false,则在本次调用绘制之前native层会先清空画布再继续绘制。 reserve参数为true,则保留当前画布上的内容,本次调用drawCanvas绘制的内容覆盖在上面。 |
| callback | function | - | 否 | 绘制完成后执行的回调函数。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(100, 10);
ctx.lineTo(100, 100);
ctx.fill();
ctx.draw(); CanvasContext.drawImage(string imageResource, number sx, number sy, number sWidth, number sHeight, number dx, number dy, number dWidth, number dHeight)
绘制图像到画布。
起始版本: 1.0.4
参数:
当前支持三种入参方式,请开发者根据实际情况选择。
CanvasContext.drawImage(string imageResource, number dx, number dy)
CanvasContext.drawImage(string imageResource, number dx, number dy, number dWidth, number dHeight)
CanvasContext.drawImage(string imageResource, number sx, number sy, number sWidth, number sHeight, number dx, number dy, number dWidth, number dHeight)
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| imageResource | string | 是 | 所要绘制的图片资源(网络图片要通过getImageInfo / downloadFile先下载)。 |
| sx | number | 否 | 需要绘制到画布中源图像的矩形选择框的左上角x坐标。 |
| sy | number | 否 | 需要绘制到画布中源图像的矩形选择框的左上角y坐标。 |
| sWidth | number | 否 | 需要绘制到画布中源图像的矩形选择框的宽度。 |
| sHeight | number | 否 | 需要绘制到画布中源图像的矩形选择框的高度。 |
| dx | number | 是 | 图像的左上角在目标canvas上x轴的位置。 |
| dy | number | 是 | 图像的左上角在目标canvas上y轴的位置。 |
| dWidth | number | 否 | 在目标画布上绘制图像的宽度,允许对绘制的图像进行缩放。 |
| dHeight | number | 否 | 在目标画布上绘制图像的高度,允许对绘制的图像进行缩放。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
has.chooseImage({
success: (res) => {
ctx.drawImage(res.tempFilePaths[0], 0, 0, 150, 100);
ctx.draw();
}
}); CanvasContext.fill()
对当前路径中的内容进行填充。默认的填充色为黑色。
起始版本: 1.0.0
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(100, 10);
ctx.lineTo(100, 100);
ctx.fill();
ctx.draw(); CanvasContext.fillRect(number x, number y, number width, number height)
填充一个矩形。用setFillStyle设置矩形的填充色,如果没有设置,默认是黑色。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 矩形路径左上角的横坐标。 |
| y | number | 是 | 矩形路径左上角的纵坐标。 |
| width | number | 是 | 矩形路径的宽度。 |
| height | number | 是 | 矩形路径的高度。 |
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.setFillStyle('blue');
ctx.fillRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.fillText(string text, number x, number y, number maxWidth)
在画布上绘制被填充的文本。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| text | string | 是 | 在画布上输出的文本。 |
| x | number | 是 | 绘制文本的左上角x坐标位置。 |
| y | number | 是 | 绘制文本的左上角y坐标位置。 |
| maxWidth | number | 否 | 需要绘制的最大宽度。 |
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.setFontSize(20);
ctx.fillText('Hello', 20, 20);
ctx.fillText('Webapp', 100, 100);
ctx.draw(); CanvasContext.lineTo(number x, number y)
增加一个新点,然后创建一条从上次指定点到目标点的线。用stroke方法来画线条。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 目标位置的x坐标。 |
| y | number | 是 | 目标位置的y坐标。 |
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(210, 60);
ctx.stroke();
ctx.draw(); CanvasContext.measureText(string text): number
测量文本尺寸信息。目前仅返回文本宽度。同步接口。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| text | string | 是 | 要测量的文本。 |
返回值:
| 参数 | 类型 | 描述 |
|---|---|---|
| width | number | 文本的宽度。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFontSize(20);
let metrics = ctx.measureText('hello world'); CanvasContext.moveTo(number x, number y)
把路径移动到画布中的指定点,不创建线条。用stroke方法来画线条。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 目标位置的x坐标。 |
| y | number | 是 | 目标位置的y坐标。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(100, 10);
ctx.moveTo(10, 50);
ctx.lineTo(100, 50);
ctx.stroke();
ctx.draw(); CanvasContext.quadraticCurveTo(number cpx, number cpy, number x, number y)
创建二次贝塞尔曲线路径。曲线的起始点为路径中前一个点。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| cpx | number | 是 | 贝塞尔控制点的x坐标。 |
| cpy | number | 是 | 贝塞尔控制点的y坐标。 |
| x | number | 是 | 结束点的x坐标。 |
| y | number | 是 | 结束点的y坐标。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(20, 20);
ctx.quadraticCurveTo(110, 100, 200, 20);
ctx.stroke();
ctx.draw(); CanvasContext.rect(number x, number y, number width, number height)
创建一个矩形路径。需要用 CanvasContext.fill 或者 CanvasContext.stroke方法将矩形真正的画到canvas中。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 矩形路径左上角的横坐标。 |
| y | number | 是 | 矩形路径左上角的纵坐标。 |
| width | number | 是 | 矩形路径的宽度。 |
| height | number | 是 | 矩形路径的高度。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.rect(10, 10, 150, 75);
ctx.setFillStyle('blue');
ctx.fill();
ctx.draw(); CanvasContext.restore()
恢复之前保存的绘图上下文。
起始版本: 1.0.0
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.save();
ctx.setFillStyle('blue');
ctx.fillRect(10, 10, 150, 100);
ctx.restore();
ctx.fillRect(50, 50, 150, 100);
ctx.draw(); CanvasContext.rotate(number rotate)
以原点为中心顺时针旋转当前坐标轴。多次调用旋转的角度会叠加。原点可以用 CanvasContext.translate方法修改。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| rotate | number | 是 | 旋转角度,以弧度计degrees * Math.PI/180;degrees范围为0 ~ 360。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.strokeRect(100, 10, 150, 100);
ctx.rotate(20 * Math.PI / 180);
ctx.strokeRect(100, 10, 150, 100);
ctx.rotate(20 * Math.PI / 180);
ctx.strokeRect(100, 10, 150, 100);
ctx.draw(); CanvasContext.save()
保存绘图上下文。
起始版本: 1.0.0
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.save();
ctx.setFillStyle('blue');
ctx.fillRect(10, 10, 150, 100);
ctx.restore();
ctx.fillRect(50, 50, 150, 100);
ctx.draw(); CanvasContext.scale(number scaleWidth, number scaleHeight)
在调用后,之后创建的路径其横、纵坐标会被缩放。多次调用倍数会相乘。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| scaleWidth | number | 是 | 横坐标缩放的倍数 (1 = 100%,0.5 = 50%,2 = 200%)。 |
| scaleHeight | number | 是 | 纵坐标轴缩放的倍数 (1 = 100%,0.5 = 50%,2 = 200%)。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(20, 20);
ctx.lineTo(100, 20);
ctx.arcTo(150, 20, 150, 70, 50);
ctx.lineTo(150, 120);
ctx.stroke();
ctx.scale(2, 2);
ctx.strokeRect(20,20,30,15);
ctx.draw(); CanvasContext.setFillStyle(string | CanvasGradient color)
设置填充色。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| color | string | CanvasGradient | black | 否 | 填充的颜色。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFillStyle('blue');
ctx.fillRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.setFontSize(number fontSize)
设置字体的字号。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| fontSize | number | 是 | 字体的字号。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFontSize(20);
ctx.fillText('20', 20, 20);
ctx.setFontSize(30);
ctx.fillText('30', 40, 40);
ctx.draw(); CanvasContext.setGlobalAlpha(number alpha)
设置全局画笔透明度。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| alpha | number | 是 | 透明度。范围0~1。 0:表示完全透明。 1:表示完全不透明。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFillStyle('blue');
ctx.fillRect(10, 10, 150, 100);
ctx.setGlobalAlpha(0.5);
ctx.setFillStyle('red');
ctx.fillRect(50, 50, 150, 100);
ctx.setFillStyle('red');
ctx.fillRect(100, 100, 150, 100);
ctx.draw(); CanvasContext.setLineCap(string lineCap)
设置线条的端点样式。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| lineCap | string | 是 | 线条的结束端点样式。 - butt:向线条的每个末端添加平直的边缘。 - round:向线条的每个末端添加圆形线帽。 - square:向线条的每个末端添加正方形线帽。 |
示例:
const ctx = has.createCanvasContext('firstCanvas');
ctx.beginPath();
ctx.moveTo(10, 10);
ctx.lineTo(150, 10);
ctx.stroke();
ctx.beginPath();
ctx.setLineCap('square');
ctx.setLineWidth(10);
ctx.moveTo(10, 70);
ctx.lineTo(150, 70);
ctx.stroke();
ctx.beginPath();
ctx.setLineCap('round');
ctx.setLineWidth(10);
ctx.moveTo(10, 50);
ctx.lineTo(150, 50);
ctx.stroke();
ctx.beginPath();
ctx.setLineCap('butt');
ctx.setLineWidth(10);
ctx.moveTo(10, 30);
ctx.lineTo(150, 30);
ctx.stroke();
ctx.draw(); CanvasContext.setLineDash(Array<number> pattern, number offset)
设置虚线样式。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| pattern | Array<number> | - | 是 | 一组描述交替绘制线段和间距(坐标空间单位)长度的数字。 |
| offset | number | 0 | 否 | 虚线偏移量。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setLineDash([10, 20], 5);
ctx.beginPath();
ctx.moveTo(0,100);
ctx.lineTo(500, 100);
ctx.stroke();
ctx.draw(); CanvasContext.setLineJoin(string lineJoin)
设置线条的交点样式。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| lineJoin | string | 是 | 线条的结束交点样式。 - bevel:斜角。 - round:圆角。 - miter:尖角。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(10, 10);
ctx.lineTo(100, 50);
ctx.lineTo(10, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineJoin('bevel');
ctx.setLineWidth(10);
ctx.moveTo(50, 10);
ctx.lineTo(140, 50);
ctx.lineTo(50, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineJoin('round');
ctx.setLineWidth(10);
ctx.moveTo(90, 10);
ctx.lineTo(180, 50);
ctx.lineTo(90, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineJoin('miter');
ctx.setLineWidth(10);
ctx.moveTo(130, 10);
ctx.lineTo(220, 50);
ctx.lineTo(130, 90);
ctx.stroke();
ctx.draw(); CanvasContext.setLineWidth(number lineWidth)
设置线条的宽度。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| lineWidth | number | 是 | 线条的宽度,单位:px。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.moveTo(10, 10);
ctx.lineTo(150, 10);
ctx.stroke();
ctx.beginPath();
ctx.setLineWidth(5);
ctx.moveTo(10, 30);
ctx.lineTo(150, 30);
ctx.stroke();
ctx.beginPath();
ctx.setLineWidth(10);
ctx.moveTo(10, 50);
ctx.lineTo(150, 50);
ctx.stroke();
ctx.draw(); CanvasContext.setMiterLimit(number miterLimit)
设置最大斜接长度。斜接长度指的是在两条线交汇处内角和外角之间的距离。
当CanvasContext.setLineJoin为miter时才有效。超过最大倾斜长度时,连接处将以lineJoin为bevel来显示。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| miterLimit | number | 是 | 最大斜接长度。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.beginPath();
ctx.setLineWidth(10);
ctx.setLineJoin('miter');
ctx.setMiterLimit(1);
ctx.moveTo(10, 10);
ctx.lineTo(100, 50);
ctx.lineTo(10, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineWidth(10);
ctx.setLineJoin('miter');
ctx.setMiterLimit(2);
ctx.moveTo(50, 10);
ctx.lineTo(140, 50);
ctx.lineTo(50, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineWidth(10);
ctx.setLineJoin('miter');
ctx.setMiterLimit(3);
ctx.moveTo(90, 10);
ctx.lineTo(180, 50);
ctx.lineTo(90, 90);
ctx.stroke();
ctx.beginPath();
ctx.setLineWidth(10);
ctx.setLineJoin('miter');
ctx.setMiterLimit(4);
ctx.moveTo(130, 10);
ctx.lineTo(220, 50);
ctx.lineTo(130, 90);
ctx.stroke();
ctx.draw(); CanvasContext.setShadow(number offsetX, number offsetY, number blur, string color)
设定阴影样式。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| offsetX | number | 是 | 阴影相对于形状在水平方向的偏移。 |
| offsetY | number | 是 | 阴影相对于形状在竖直方向的偏移。 |
| blur | number | 是 | 阴影的模糊级别,数值越大越模糊。范围0 ~ 100。 |
| color | string | 是 | 阴影的颜色。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFillStyle('blue');
ctx.setShadow(10, 50, 50, 'blue');
ctx.fillRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.setStrokeStyle(string | CanvasGradient color)
设置描边颜色。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| color | string | CanvasGradient | black | 否 | 描边的颜色。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setStrokeStyle('blue');
ctx.strokeRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.setTextAlign(string align)
设置文字的对齐方式。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| align | string | 是 | 文字的对齐方式。 |
align的合法值:
| 值 | 描述 |
|---|---|
| left | 左对齐。 |
| center | 居中对齐。 |
| right | 右对齐。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(150, 20);
ctx.lineTo(150, 170);
ctx.stroke();
ctx.setFontSize(15);
ctx.setTextAlign('left');
ctx.fillText('textAlign=left', 150, 60);
ctx.setTextAlign('right');
ctx.fillText('textAlign=right', 150, 100);
ctx.setTextAlign('center');
ctx.fillText('textAlign=center', 150, 80);
ctx.draw(); CanvasContext.setTransform(number scaleX, number skewX, number skewY, number scaleY, number translateX, number translateY)
使用矩阵重新设置(覆盖)当前变换的方法。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| scaleX | number | 是 | 水平缩放。 |
| skewX | number | 是 | 水平倾斜。 |
| skewY | number | 是 | 垂直倾斜。 |
| scaleY | number | 是 | 垂直缩放。 |
| translateX | number | 是 | 水平移动。 |
| translateY | number | 是 | 垂直移动。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.fillStyle = '#FFFF00';
ctx.fillRect(0, 0, 250, 100);
ctx.setTransform(1, 0.5, -0.5, 1, 30, 10);
ctx.fillStyle = 'blue';
ctx.fillRect(0, 0, 250, 100);
ctx.setTransform(1, 0.5, -0.5, 1, 30, 10);
ctx.fillStyle = 'black';
ctx.fillRect(0, 0, 250, 100);
ctx.draw(); CanvasContext.stroke()
画出当前路径的边框。默认颜色为黑色。
起始版本: 1.0.4
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(10, 10);
ctx.lineTo(100, 10);
ctx.lineTo(100, 100);
ctx.stroke();
ctx.draw(); CanvasContext.strokeRect(number x, number y, number width, number height)
画一个矩形(非填充)。 用CanvasContext.setStrokeStyle设置矩形线条的颜色,如果没设置默认是黑色。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 矩形路径左上角的横坐标。 |
| y | number | 是 | 矩形路径左上角的纵坐标。 |
| width | number | 是 | 矩形路径的宽度。 |
| height | number | 是 | 矩形路径的高度。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setStrokeStyle('blue');
ctx.strokeRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.strokeText(string text, number x, number y, number maxWidth)
给定的(x, y)位置绘制文本描边的方法。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| text | string | 是 | 要绘制的文本。 |
| x | number | 是 | 文本起始点的x轴坐标。 |
| y | number | 是 | 文本起始点的y轴坐标。 |
| maxWidth | number | 否 | 需要绘制的最大宽度。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.setFontSize(20);
ctx.strokeText('Hello Web!', 10, 50);
ctx.setFontSize(30);
let gradient = ctx.createLinearGradient(0, 0, 200, 0);
gradient.addColorStop(0, 'magenta');
gradient.addColorStop(0.5, 'blue');
gradient.addColorStop(1.0, 'black');
ctx.strokeStyle = gradient;
ctx.strokeText('atomicservice.com', 10, 90);
ctx.draw(); CanvasContext.transform(number scaleX, number skewX, number skewY, number scaleY, number translateX, number translateY)
使用矩阵多次叠加当前变换的方法。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| scaleX | number | 是 | 水平缩放。 |
| skewX | number | 是 | 水平倾斜。 |
| skewY | number | 是 | 垂直倾斜。 |
| scaleY | number | 是 | 垂直缩放。 |
| translateX | number | 是 | 水平移动。 |
| translateY | number | 是 | 垂直移动。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.fillStyle = '#FFFF00';
ctx.fillRect(0, 0, 250, 100);
ctx.transform(1, 0.5, -0.5, 1, 30, 10);
ctx.fillStyle = 'blue';
ctx.fillRect(0, 0, 250, 100);
ctx.transform(1, 0.5, -0.5, 1, 30, 10);
ctx.fillStyle = 'black';
ctx.fillRect(0, 0, 250, 100);
ctx.draw(); CanvasContext.translate(number x, number y)
对当前坐标系的原点 (0, 0) 进行变换。默认的坐标系原点为页面左上角。
起始版本: 1.0.4
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 水平坐标平移量。 |
| y | number | 是 | 竖直坐标平移量。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.strokeRect(10, 10, 150, 100);
ctx.translate(20, 20);
ctx.strokeRect(10, 10, 150, 100);
ctx.translate(20, 20);
ctx.strokeRect(10, 10, 150, 100);
ctx.draw(); CanvasContext.setTextBaseline(string textBaseline)
设置文字的竖直对齐方式。
起始版本: 1.0.0
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| textBaseline | string | 是 | 文字的竖直对齐方式。 - top:顶部对齐。 - bottom:底部对齐。 - middle:居中对齐。 - normal:标准的字母基线对齐(默认对齐方式)。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
ctx.moveTo(5, 75);
ctx.lineTo(295, 75);
ctx.stroke();
ctx.setFontSize(20);
ctx.setTextBaseline('normal');
ctx.fillText('normal', 200, 75);
ctx.setTextBaseline('top');
ctx.fillText('top', 5, 75);
ctx.setTextBaseline('middle');
ctx.fillText('middle', 50, 75);
ctx.setTextBaseline('bottom');
ctx.fillText('bottom', 120, 75);
ctx.draw(); CanvasContext.clearRect(number x, number y, number width, number height)
清除画布上在该矩形区域内的内容。
起始版本: 1.0.3
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| x | number | 是 | 矩形路径左上角的横坐标。 |
| y | number | 是 | 矩形路径左上角的纵坐标。 |
| width | number | 是 | 矩形路径的宽度,单位vp。 |
| height | number | 是 | 矩形路径的高度,单位vp。 |
示例:
使用draw方法绘制结果。
const ctx = has.createCanvasContext('myCanvas');
ctx.setFillStyle('red');
ctx.fillRect(0, 0, 150, 200);
ctx.setFillStyle('blue');
ctx.fillRect(150, 0, 150, 200);
ctx.clearRect(10, 10, 150, 75);
ctx.draw(); CanvasContext.createPattern(string image, string repetition);
对指定的图像创建模式的方法,可在指定的方向上重复元图像。
起始版本: 1.0.3
参数:
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| image | string | 是 | 重复的图像源,支持代码包路径和本地临时路径(本地路径)。 |
| repetition | string | 是 | 如何重复图像。 - repeat:水平竖直方向都重复。 - repeat-x:水平方向重复。 - repeat-y:竖直方向重复。 - no-repeat:不重复。 |
示例:
const ctx = has.createCanvasContext('myCanvas');
const pattern = ctx.createPattern('internal://files/startIcon.png', 'repeat');
ctx.setFillStyle(pattern);
ctx.fillRect(10, 10, 100, 100);
ctx.draw();