Skip to content

原生canvas

Jump to bottom
何波 edited this page Apr 9, 2019 · 27 revisions

canvas参考手册

Canvas API中文文档首页地图

canvas绘图API都保存在canvas.getContext('2d')对象上的

let canvas = document.createElement('canvas');
let ctx = canvas.getContext('2d')
console.info(ctx)
var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
ctx.beginPath();
ctx.moveTo(0,0);
ctx.lineTo(300,150);
ctx.stroke();

注意：在绘制前，只是设置了样式，或绘制的路径，最后一步context.stroke()或context.fill()才是真正的绘制，前面的操作看不见。

颜色、样式和阴影

属性 描述
fillStyle 设置或返回用于填充绘画的颜色、渐变或模式
strokeStyle 设置或返回用于笔触的颜色、渐变或模式
shadowColor 设置或返回用于阴影的颜色
shadowBlur 设置或返回用于阴影的模糊级别
shadowOffsetX 设置或返回阴影距形状的水平距离
shadowOffsetY 设置或返回阴影距形状的垂直距离
方法 描述
createLinearGradient() 创建线性渐变（用在画布内容上）
createPattern() 在指定的方向上重复指定的元素
createRadialGradient() 创建放射状/环形的渐变（用在画布内容上）
addColorStop() 规定渐变对象中的颜色和停止位置

线条样式

属性 描述
lineCap 设置或返回线条的结束端点样式
lineJoin 设置或返回两条线相交时，所创建的拐角类型
lineWidth 设置或返回当前的线条宽度
miterLimit 设置或返回最大斜接长度

矩形

方法 描述
rect() 创建矩形
fillRect() 绘制“被填充”的矩形
strokeRect() 绘制矩形（无填充）
clearRect() 在给定的矩形内清除指定的像素

路径

方法 描述
fill() 填充当前绘图（路径）
stroke() 绘制已定义的路径
beginPath() 起始一条路径，或重置当前路径
moveTo() 把路径移动到画布中的指定点，不创建线条
closePath() 创建从当前点回到起始点的路径
lineTo() 添加一个新点，然后在画布中创建从该点到最后指定点的线条
clip() 从原始画布剪切任意形状和尺寸的区域
quadraticCurveTo() 创建二次贝塞尔曲线
bezierCurveTo() 创建三次方贝塞尔曲线
arc() 创建弧/曲线（用于创建圆形或部分圆）
arcTo() 创建两切线之间的弧/曲线
isPointInPath() 如果指定的点位于当前路径中，则返回 true，否则返回 false

转换

方法 描述
scale() 缩放当前绘图至更大或更小
rotate() 旋转当前绘图
translate() 重新映射画布上的 (0,0) 位置
transform() 替换绘图的当前转换矩阵
setTransform() 将当前转换重置为单位矩阵。然后运行 transform()

文本

属性 描述
font 设置或返回文本内容的当前字体属性
textAlign 设置或返回文本内容的当前对齐方式
textBaseline 设置或返回在绘制文本时使用的当前文本基线
方法 描述
fillText() 在画布上绘制“被填充的”文本
strokeText() 在画布上绘制文本（无填充）
measureText() 返回包含指定文本宽度的对象

图像绘制

方法 描述
drawImage() 向画布上绘制图像、画布或视频

像素操作

属性 描述
width 返回 ImageData 对象的宽度
height 返回 ImageData 对象的高度
data 返回一个对象，其包含指定的 ImageData 对象的图像数据
方法 描述
createImageData() 创建新的、空白的 ImageData 对象
getImageData() 返回 ImageData 对象，该对象为画布上指定的矩形复制像素数据
putImageData() 把图像数据（从指定的 ImageData 对象）放回画布上

合成

属性 描述
globalAlpha 设置或返回绘图的当前 alpha 或透明值
globalCompositeOperation 设置或返回新图像如何绘制到已有的图像上

其他

方法 描述
save() 保存当前环境的状态
restore() 返回之前保存过的路径状态和属性
createEvent()
getContext()
toDataURL()

图像像素

我们要知道，一个图形对象上的每一点像素都是从上到下一行一行（每一行里又是从左到右）有序地排列着的，而每一个像素又有四个数值（RGBA）表示它的颜色。

比如下方有一个非常简单的图形对象（假设我把它放大了75倍，方便查看），它一共只有四个像素点，这四个像素点的RGBA数值分别是(255,255,0,255)、(0,255,64,255)、(43,149,255,255)、(236,103,100,51) ： 那么这个图形对象的“像素数据”可以看为一个数组： [255,255,0,255,0,255,64,255,43,149,255,255,236,103,100,51]

也就是把四个像素的RGBA数据依次拼起来。当然这里只是一个非常简单的例子，常规的图像可能有几千几万个像素，但它们的像素数据都遵循这种存储方式。

ImageData你可以理解为“含像素数据的图形对象”，“像素数据”指的是该图形对象上的每一个有序的像素的数据，每个像素都有它对应的颜色数据（RGBA值）。

我们可以通过 createImageData(width,height) 方法来创建一个ImageData对象，然后通过 putImageData(imgData,x,y) 方法把ImageData对象放到画布上：

let c = document.getElementById("myCanvas");
let ctx = c.getContext("2d");
let imgData = ctx.createImageData(200,100); // 创建一个宽为200，高为100的ImageData对象
for (let i=0;i<imgData.data.length;i+=4) {  // 遍历ImageData对象的每一个像素点，并给它们上色
    imgData.data[i+0]=255;
    imgData.data[i+1]=100;
    imgData.data[i+2]=0;
    imgData.data[i+3]=255;
}
ctx.putImageData(imgData,50,60);  // 将上述创建的ImageData对象放到画布坐标（50,60）的位置

其实 putImageData() 方法还有四个可选参数，可以用来裁剪ImageData对象上的指定区域。其全部参数为： ctx.putImageData( imgData, x, y, clip_X, clip_Y, clip_Width, clip_Height); clip_X,clip_Y分别表示相对于ImageData对象的裁剪起始点坐标，clip_Width, clip_Height表示要裁剪的矩形区域宽高。

ctx.getImageData(x,y,width,height)

  • x:开始复制的左上角位置的 x 坐标
  • y:开始复制的左上角位置的 y 坐标
  • width:将要复制的矩形区域的宽度
  • height:将要复制的矩形区域的高度 getImageData() 方法返回 ImageData 对象，该对象拷贝了画布指定矩形的像素数据。
let c=document.getElementById("myCanvas");
let ctx=c.getContext("2d");
ctx.fillStyle="green";
ctx.fillRect(10,10,50,50);

let imgData = ctx.getImageData(30,30,50,50);
let red = imgData.data[0];
let green = imgData.data[1];
let blue = imgData.data[2];
let alpha = imgData.data[3];
console.info(red + " " + green + " " + blue + " " + alpha);

ctx.drawImage(image,sx,sy,sWidth,sHeight,dx,dy,dWidth,dHeight)

  • image:image或canvas对象
  • sx,sy: 源对象的x,y坐标
  • sWidth,sHeight 源对象的宽高 可选
  • dx,dy: 画布上的x,y坐标
  • dWidth,dHeight 在画布上绘制的宽高 可选

ctx.translate(x,y)

在位置 (10,10) 处绘制一个矩形，将新的 (0,0) 位置设置为 (70,70)。再次绘制新的矩形（请注意现在矩形从位置 (80,80) 开始绘制）：

ctx.rotate(angle)

旋转角度，以弧度计

// 将矩形旋转 20 度
let c = document.getElementById("myCanvas")
let ctx = c.getContext("2d")
ctx.rotate(20*Math.PI/180)
ctx.fillRect(50,20,100,50)

ctx.scale(scalewidth,scaleheight)

let c=document.getElementById("myCanvas");
let ctx = c.getContext("2d")
ctx.strokeRect(5,5,25,15)
ctx.scale(2,2)
ctx.strokeRect(5,5,25,15)

ctx.setTransform(mtx.a, mtx.b, mtx.c, mtx.d, mtx.tx, mtx.ty);

  • mtx.a:水平旋转绘图
  • mtx.b:水平倾斜绘图
  • mtx.c:垂直倾斜绘图
  • mtx.d:垂直缩放绘图
  • mtx.tx:水平移动绘图
  • mtx.ty:垂直移动绘图

将当前转换重置为单位矩阵。然后运行 transform() setTransform() 方法把当前的变换矩阵重置为单位矩阵，然后以相同的参数运行 transform()。

ctx.transform(mtx.a, mtx.b, mtx.c, mtx.d, mtx.tx, mtx.ty)

替换绘图的当前转换矩阵 transform会在前面的变换基础上进行变换，而setTransform会重置。这是两者区别。

let mtx = new createjs.Matrix2D();
if (mtx) { ctx.save(); ctx.transform(mtx.a, mtx.b, mtx.c, mtx.d, mtx.tx, mtx.ty); }
ctx.fill();
if (mtx) { ctx.restore(); }

drawImage() 方法在画布上绘制图像、画布或视频。

context.drawImage(img,x,y);

在画布上放置图像在x,y坐标处

context.drawImage(img,x,y,width,height);

在画布上定位图像，并规定图像的宽度和高度

context.drawImage(img,sx,sy,swidth,sheight,x,y,width,height);

剪切图像，并在画布上定位被剪切的部分。drawImage(img,sx,sy,swidth,sheight,x,y,width,height)加粗为裁切参数。

  • img:规定要使用的图像、画布或视频。
  • sx:可选。开始剪切的 x 坐标位置。
  • sy:可选。开始剪切的 y 坐标位置。
  • swidth:可选。被剪切图像的宽度。
  • sheight:可选。被剪切图像的高度。
  • x:在画布上放置图像的 x 坐标位置。
  • y:在画布上放置图像的 y 坐标位置。
  • width:可选。要使用的图像的宽度。（伸展或缩小图像）
  • height:可选。要使用的图像的高度。（伸展或缩小图像）

Clone this wiki locally