ImageData
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Canvas API")}}{{AvailableInWorkers}}
The **ImageData** interface represents the underlying pixel data of an area of a {{HTMLElement("canvas")}} element.
It is created using the {{domxref("ImageData.ImageData", "ImageData()")}} constructor or creator methods on the {{domxref("CanvasRenderingContext2D")}} object associated with a canvas: {{domxref("CanvasRenderingContext2D.createImageData", "createImageData()")}} and {{domxref("CanvasRenderingContext2D.getImageData", "getImageData()")}}. It can also be used to set a part of the canvas by using {{domxref("CanvasRenderingContext2D.putImageData", "putImageData()")}}.
Constructors
- {{domxref("ImageData.ImageData", "ImageData()")}}
- : Creates an
ImageDataobject from a given {{jsxref("Uint8ClampedArray")}} or {{jsxref("Float16Array")}} and the size of the image it contains. If no array is given, it creates an image of a transparent black rectangle. Note that this is the most common way to create such an object in workers as {{domxref("CanvasRenderingContext2D.createImageData", "createImageData()")}} is not available there.
Instance properties
- {{domxref("ImageData.data")}} {{ReadOnlyInline}}
- : A {{jsxref("Uint8ClampedArray")}} or {{jsxref("Float16Array")}} representing a one-dimensional array containing the data in the RGBA order. The order goes by rows from the top-left pixel to the bottom-right.
- {{domxref("ImageData.colorSpace")}} {{ReadOnlyInline}}
- : A string indicating the color space of the image data.
- {{domxref("ImageData.height")}} {{ReadOnlyInline}}
- : An
unsigned longrepresenting the actual height, in pixels, of theImageData. - {{domxref("ImageData.width")}} {{ReadOnlyInline}}
- : An
unsigned longrepresenting the actual width, in pixels, of theImageData. - {{domxref("ImageData.pixelFormat")}} {{ReadOnlyInline}} {{experimental_inline}}
- : A string indicating the format to use for the
ImageData.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("CanvasRenderingContext2D")}}
- The {{HTMLElement("canvas")}} element and its associated interface, {{domxref("HTMLCanvasElement")}}.