HTML5 canvas createImageData() 方法

w3school 在线教程

## HTML5 教程

- HTML5 教程
- HTML5 简介
- HTML5 视频
- HTML5 视频/DOM
- HTML5 音频
- HTML5 拖放
- HTML5 画布
- HTML5 SVG
- HTML5 画布 vs SVG
- HTML5 地理定位
- HTML5 Web 存储
- HTML5 应用缓存
- HTML5 Web Workers
- HTML5 服务器发送事件

## HTML5 表单

- HTML5 输入类型
- HTML5 表单元素
- HTML5 表单属性

## HTML5 测验

- HTML5 测验

## HTML5 参考手册

- HTML5 标签
- HTML5 属性
- HTML5 事件
- HTML5 视频/音频
- HTML5 画布
- HTML 有效 DTD

# HTML5 canvas createImageData() 方法

HTML5 Canvas 参考手册

## 实例

创建 100*100 像素的 ImageData 对象，其中每个像素都是红色的，然后把它放到画布上：

JavaScript:

    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);

亲自试一试

## 浏览器支持

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 对象的四倍。（获得数组大小有更简单的办法，就是使用 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 对象：

    var imgData=context.createImageData(width,height);

2. 创建与指定的另一个 ImageData 对象尺寸相同的新 ImageData 对象（不会复制图像数据）：

    var imgData=context.createImageData(imageData);

### 参数值

参数 | 描述
--- | ---
width | ImageData 对象的宽度，以像素计。
height | ImageData 对象的高度，以像素计。
imageData | 另一个 ImageData 对象。

HTML5 Canvas 参考手册