createImageData() 是 Canvas 2D API 创建一个新的、空白的、指定大小的 ImageData 对象。 所有的像素在新对象中都是透明的。
在线示例
创建一个100 * 100像素的ImageData对象，其中每个像素均为红色，然后将其放在画布上：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>HTML canvas createImageData()方法使用-大卫编程网(div.cn)</title>
</head>
<body>
<canvas id="myCanvas" width="300" height="150" style="border:1px solid #d3d3d3;">
您的浏览器不支持 HTML5 canvas 标签。
</canvas>
<script>
var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var imgData=ctx.createImageData(100,100);
for (var i=0;i<imgData.data.length;i+=4)
{
imgData.data[i+0]=255;
imgData.data[i+1]=0;
imgData.data[i+2]=0;
imgData.data[i+3]=255;
}
ctx.putImageData(imgData,10,10);
</script>
</body>
</html>测试看看 ‹/›浏览器兼容性
IEFirefoxOperaChromeSafari
Internet Explorer 9、Firefox、Opera、Chrome 和 Safari 支持 createImageData() 方法。
注意：Internet Explorer 8 及之前的版本不支持 <canvas> 元素。
定义和用法
createImageData() 方法创建新的空白 ImageData 对象。新对象的默认像素值 transparent black。
对于 ImageData 对象中的每个像素，都存在着四方面的信息，即 RGBA 值：
R - 红色（0-255）
G - 绿色（0-255）
B - 蓝色（0-255）
A - alpha 通道（0-255; 0 是透明的，255 是完全可见的）
因此 ，transparent black 表示 (0,0,0,0)。
color/alpha 信息以数组形式存在，并且由于数组包含了每个像素的四条信息，所以数组的大小是 ImageData 对象的四倍：width*height*4。（获得数组大小有更简单的办法，就是使用 ImageDataObject.data.length）
包含 color/alpha 信息的数组存储于 ImageData 对象的 data 属性中。
提示：在操作完成数组中的 color/alpha 信息之后，您可以使用 putImageData() 方法将图像数据拷贝回画布上。
示例：
把 ImageData 对象中的第一个像素变为红色的语法：
imgData=ctx.createImageData(100,100); imgData.data[0]=255; imgData.data[1]=0; imgData.data[2]=0; imgData.data[3]=255;
把 ImageData 对象中的第二个像素变为绿色的语法：
imgData=ctx.createImageData(100,100); imgData.data[4]=0; imgData.data[5]=255; imgData.data[6]=0; imgData.data[7]=255;
JavaScript 语法
有两个版本的 createImageData() 方法：
1. 以指定的尺寸（以像素计）创建新的 ImageData 对象：
| JavaScript 语法： | var imgData=context.createImageData(width,height); |
|---|
2. 创建与指定的另一个 ImageData 对象尺寸相同的新 ImageData 对象（不会复制图像数据）：
| JavaScript 语法： | var imgData=context.createImageData(imageData); |
|---|
参数值
| 参数 | 描述 |
|---|---|
| width | ImageData 对象的宽度，以像素计。 |
| height | ImageData 对象的高度，以像素计。 |
| imageData | 另一个 ImageData 对象。 |