HTML canvas createImageData() 方法

HTML canvas 參考手冊 HTML canvas 參考手冊

實例

創建 100*100 像素的 ImageData 對象，其中每個像素都是紅色的，然後把它放到畫布上：

YourbrowserdoesnotsupporttheHTML5canvastag.

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 ExplorerFirefoxOperaGoogle ChromeSafari

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 對象。

HTML canvas 參考手冊 HTML canvas 參考手冊