Metoda createImageData() Canvas

Podręcznik Canvas

Definicja i użycie

createImageData() Metoda tworzenia nowego pustego obiektu ImageData. Domyślna wartość pixela nowego obiektu to przezroczysta czarna.

Dla każdego pixela w obiekcie ImageData istnieją cztery rodzaje informacji, znane jako wartości RGBA:

  • R - czerwony (0-255)
  • G - zielony (0-255)
  • B - niebieski (0-255)
  • A - kanał alfa (0-255; 0 to przezroczysty, 255 to w pełni widoczny)

Dlatego przezroczysta czarna to (0,0,0,0).

Informacje o kolorze/alphie istnieją w formie tablicy i ponieważ tablica zawiera cztery informacje dla każdego pixela, jej rozmiar jest czterokrotnie większy niż obiekt ImageData (można uzyskać rozmiar tablicy w prostszy sposób, używając ImageDataObject.data.length)

Tablica zawierająca informacje o kolorze/alphie jest przechowywana w obiekcie ImageData w data w właściwościach.

Wskazówka:Po zakończeniu operacji na informacji o kolorze/alphie w tablicy, możesz użyć putImageData() Metoda kopiuje dane obrazu z powrotem na płótno.

Przykład:

Ta syntaktyka zmienia pierwszy piksel obiektu ImageData na czerwony:

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

Ta syntaktyka zmienia drugi piksel obiektu ImageData na czerwony:

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

Przykład

Utwórz obiekt ImageData o wymiarach 100x100 pikseli, gdzie każdy piksel jest czerwony, a następnie umieść go na płótnie:

Twoja przeglądarka nie obsługuje etykiety HTML5 canvas.

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

Spróbuj sam!

Syntaktyka

Istnieją dwie wersje metody createImageData():

1. Utwórz nowy obiekt ImageData o podanych rozmiarach (wyrażonych w pikselach):

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

2. Utwórz nowy obiekt ImageData o rozmiarze zgodnym z podanym innym obiektem ImageData (nie skopiuj danych obrazu):

var imgData=context.createImageData(imageData);

Wartość parametru

Parametr Opis
width Szerokość obiektu ImageData, wyrażona w pikselach.
height Wysokość obiektu ImageData, wyrażona w pikselach.
imageData Kolejny obiekt ImageData.

Wspierane przeglądarki

Liczby w tabeli wskazują na pierwszą wersję przeglądarki, która w pełni obsługuje tę właściwość.

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

Komentarz:Internet Explorer 8 i wcześniejsze wersje nie obsługują elementu <canvas>.

Podręcznik Canvas