ImageData() | Web API

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

ImageData() constructor returns a newly instantiated ImageData object built from the typed array given and having the specified width and height.

This constructor is the preferred way of creating such an object in a Worker .

句法

new ImageData(array, width [, height]);
new ImageData(width, height);

参数

array 可选: Uint8ClampedArray containing the underlying pixel representation of the image. If no such array is given, an image with a transparent black rectangle of the specified width and height 将被创建。
width
height

返回值

新的 ImageData 对象。

Errors thrown

IndexSizeError: Thrown if array is specified, but its length is not a multiple of (4 * width) or (4 * width * height) .

范例

Creating a blank ImageData object

This example creates an ImageData object that is 200 pixels wide and 100 pixels tall, containing a total of 20,000 pixels.

let imageData = new ImageData(200, 100);
// ImageData { width: 200, height: 100, data: Uint8ClampedArray[80000] }

Initializing ImageData with an array

This example instantiates an ImageData object with pixel colors defined by an array.

HTML

<canvas id="canvas"></canvas>

JavaScript

The array ( arr ) has a length of 40000 : it consists of 10,000 pixels, each of which is defined by 4 values. The ImageData constructor specifies a width of 200 for the new object, so its height defaults to 10,000 divided by 200, which is 50 .

const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
const arr = new Uint8ClampedArray(40000);
// Iterate through every pixel
for (let i = 0; i < arr.length; i += 4) {
  arr[i + 0] = 0;    // R value
  arr[i + 1] = 190;  // G value
  arr[i + 2] = 0;    // B value
  arr[i + 3] = 255;  // A value
}
// Initialize a new ImageData object
let imageData = new ImageData(arr, 200);
// Draw image data to the canvas
ctx.putImageData(imageData, 20, 20);

结果

规范

规范	状态	注释
HTML 实时标准 The definition of 'ImageData()' in that specification.	实时标准	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`ImageData()` 构造函数	Chrome 42	Edge ≤18	Firefox 29	IE No	Opera 29	Safari ?	WebView Android No	Chrome Android 42	Firefox Android 29	Opera Android ?	Safari iOS ?	Samsung Internet Android 4.0

图例

完整支持
不支持
兼容性未知 ?
实验。期望将来行为有所改变。

另请参阅

CanvasRenderingContext2D.createImageData() , the creator method that can be used outside workers.

元数据

最后修改： Jul 3, 2020

在此页

句法

参数

返回值