Canvas createImageData() 方法

定义和用法

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() Metodi kopioi kuvatiedot takaisin lavoille.

Esimerkki:

Tämä syntaksi muuttaa ImageData-objektin ensimmäisen kuvapisteen punaiseksi:

imgData=ctx.createImageData(100,100);
imgData.data[0]=255;
imgData.data[1]=0;
imgData.data[2]=0;
imgData.data[3]=255;

Tämä syntaksi muuttaa ImageData-objektin toisen kuvapisteen punaiseksi:

imgData=ctx.createImageData(100,100);
imgData.data[4]=0;
imgData.data[5]=255;
imgData.data[6]=0;
imgData.data[7]=255;

Esimerkki

Luo 100*100 kuvapisteen suuruinen ImageData-objekti, jossa jokainen kuvapiste on punainen, ja lisää se taustaleveyteen:

Selaimesi ei tue HTML5 canvas -tagia.

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

Kokeile itse

Syntaksi

On kaksi versiota createImageData() -metodista:

1. Luo uusi ImageData-objekti määritetyllä koolla (kuvapisteinä):

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

2. Luo uusi ImageData-objekti, jolla on sama koko kuin määritetty toinen ImageData-objekti (ei kopioi kuvatietoja):

var imgData=context.createImageData(imageData);

Parametrin arvo

Parametri Kuvaus
width ImageData-objektin leveys, kuvapisteinä.
height ImageData-objektin korkeus, kuvapisteinä.
imageData Toinen ImageData-objekti.

Selaimen tuki

Taulukossa olevat numerot osoittavat ensimmäisen täysin tukevan siihen ominaisuuden selaimen version.

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
4.0 9.0 3.6 4.0 10.1

Huomautus:Internet Explorer 8 ja aikaisemmat versiot eivät tue <canvas>-elementtiä.