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() 이 메서드는 이미지 데이터를 캔버스에 복사합니다.

예제:

이 문법은 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;

예제

100*100 픽셀의 ImageData 객체를 생성하고, 각 픽셀을 빨간색으로 설정한 후 그려보세요:

브라우저는 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);

직접 시도해 보세요

문법

createImageData() 메서드는 두 버전이 있습니다:

1. 지정된 크기(픽셀로 측정)의 새로운 ImageData 객체를 생성합니다:

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

2. 지정된 다른 ImageData 객체와 같은 크기의 새로운 ImageData 객체를 생성합니다. (이미지 데이터를 복사하지 않습니다):

var imgData=context.createImageData(imageData);

매개변수 값

매개변수 설명
width ImageData 객체의 너비는 픽셀로 측정됩니다.
height ImageData 객체의 높이는 픽셀로 측정됩니다.
imageData 또 다른 ImageData 객체.

브라우저 지원

표의 숫자는 해당 속성을 최초로 완전히 지원하는 브라우저 버전을 나타냅니다.

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

주의사항:Internet Explorer 8 및 이전 버전은 <canvas> 요소를 지원하지 않습니다.