HTML-Canvas createImageData()Methode

Canvas 对象参考手册Canvas 对象

Beispiel

Erstellen Sie ein ImageData-Objekt mit 100*100 Pixeln, bei dem jedes Pixel rot ist, und legen Sie es dann auf dem Canvas ab:

Ihr Browser unterstützt das HTML5-Canvas-Tag nicht.

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

Selbst ausprobieren »

Browser-Unterstützung

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Internet Explorer 9, Firefox, Opera, Chrome und Safari unterstützen die createImageData()-Methode.

Hinweis:Internet Explorer 8 und frühere Versionen unterstützen das <canvas>-Element nicht.


Definition und Verwendung

Die createImageData()-Methode erstellt ein neues leeres ImageData-Objekt. Der Standardpixelwert des neuen Objekts ist transparentes Schwarz.

Für jedes Pixel im ImageData-Objekt gibt es vier Informationen, nämlich die RGBA-Werte:

R - Rot (0-255)
G - Grün (0-255)
B - Blau (0-255)
A - Alpha-Kanal (0-255; 0 ist transparent, 255 ist vollständig sichtbar)

Daher bedeutet transparentes Schwarz (0,0,0,0).

Die Farb-/Alpha-Informationen werden in einem Array gespeichert, und das Array enthält vier Informationen für jedes Pixel; die Größe des Arrays ist viermal so groß wie die des ImageData-Objekts: width*height*4. (Es gibt eine einfachere Möglichkeit, die Array-Größe zu ermitteln, nämlich ImageDataObject.data.length zu verwenden.)

Das Array mit den Farb-/Alpha-Informationen wird in derdata-Eigenschaft des ImageData-Objekts gespeichert.

Tipp:Nachdem Sie die Farb-/Alpha-Informationen im Array bearbeitet haben, können Sie dieputImageData()-Methode verwenden, um die Bilddaten zurück auf das Canvas zu kopieren.

Beispiel:

Syntax, um das erste Pixel im ImageData-Objekt rot zu färben:

imgData=ctx.createImageData(100,100);

imgData.data[0]=255;
imgData.data[1]=0;
imgData.data[2]=0;
imgData.data[3]=255;

Syntax, um das zweite Pixel im ImageData-Objekt grün zu färben:

imgData=ctx.createImageData(100,100);

imgData.data[4]=0;
imgData.data[5]=255;
imgData.data[6]=0;
imgData.data[7]=255;


JavaScript-Syntax

Es gibt zwei Versionen der createImageData()-Methode:

1. Erstellen Sie ein neues ImageData-Objekt mit den angegebenen Abmessungen (in Pixeln):

JavaScript-Syntax: var imgData=context.createImageData(width,height);

2. Erstellen Sie ein neues ImageData-Objekt mit denselben Abmessungen wie ein anderes angegebenes ImageData-Objekt (ohne die Bilddaten zu kopieren):

JavaScript-Syntax: var imgData=context.createImageData(imageData);

Parameterwerte

Parameter Beschreibung
width Die Breite des ImageData-Objekts in Pixeln.
height Die Höhe des ImageData-Objekts in Pixeln.
imageData Ein weiteres ImageData-Objekt.


Canvas 对象参考手册Canvas 对象

Andere Erweiterungen