Méthode createImageData()du canvas HTML

Canvas 对象参考手册Objet Canvas

Exemple

Créez un objet ImageData de 100*100 pixels où chaque pixel est rouge, puis placez-le sur le canvas :

Votre navigateur ne prend pas en charge la balise canvas HTML5.

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

Essayez-le vous-même »

Prise en charge des navigateurs

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Internet Explorer 9, Firefox, Opera, Chrome et Safari prennent en charge la méthode createImageData().

Remarque :Internet Explorer 8 et les versions antérieures ne prennent pas en charge l'élément <canvas>.


Définition et utilisation

La méthode createImageData() crée un nouvel objet ImageData vide. La valeur de pixel par défaut du nouvel objet est un noir transparent.

Pour chaque pixel de l'objet ImageData, il y a quatre informations, à savoir les valeurs RGBA :

R - Rouge (0-255)
G - Vert (0-255)
B - Bleu (0-255)
A - canal alpha (0-255 ; 0 est transparent, 255 est entièrement visible)

Par conséquent, le noir transparent signifie (0,0,0,0).

Les informations de couleur/alpha sont stockées dans un tableau, et comme le tableau contient quatre informations pour chaque pixel, la taille du tableau est quatre fois celle de l'objet ImageData : width*height*4. (Il existe une façon plus simple d'obtenir la taille du tableau, qui consiste à utiliser ImageDataObject.data.length)

Le tableau contenant les informations de couleur/alpha est stocké dans la propriétédatade l'objet ImageData.

Astuce :Après avoir terminé de manipuler les informations de couleur/alpha dans le tableau, vous pouvez utiliser la méthodeputImageData()pour recopier les données d'image vers le canevas.

Exemple :

Syntaxe pour mettre en rouge le premier pixel de l'objet ImageData :

imgData=ctx.createImageData(100,100);

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

Syntaxe pour mettre en vert le deuxième pixel de l'objet ImageData :

imgData=ctx.createImageData(100,100);

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


Syntaxe JavaScript

Il existe deux versions de la méthode createImageData() :

1. Créez un nouvel objet ImageData avec les dimensions spécifiées (en pixels) :

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

2. Créez un nouvel objet ImageData avec les mêmes dimensions qu'un autre objet ImageData spécifié (ne copie pas les données d'image) :

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

Valeurs des paramètres

Paramètre Description
width La largeur de l'objet ImageData, en pixels.
height La hauteur de l'objet ImageData, en pixels.
imageData Un autre objet ImageData.


Canvas 对象参考手册Objet Canvas

Autres extensions