ImageData

Baseline 廣泛可用 *

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

注意：此功能在 Web Workers 中可用。

ImageData 介面代表了 <canvas> 元素區域的底層畫素資料。

它可以透過 ImageData() 建構函式或與畫布關聯的 CanvasRenderingContext2D 物件上的建立方法 createImageData() 和 getImageData() 來建立。它還可以透過 putImageData() 來設定畫布的一部分。

建構函式

ImageData(): 從給定的 Uint8ClampedArray 或 Float16Array 以及其中包含的影像大小建立 ImageData 物件。如果沒有提供陣列，它將建立一個透明的黑色矩形影像。請注意，這是在 worker 中建立此類物件的常用方法，因為 createImageData() 在那裡不可用。

ImageData.data 只讀: 一個 Uint8ClampedArray 或 Float16Array，表示一個包含 RGBA 順序資料的的一維陣列。順序按行從左上角畫素到右下角排列。
ImageData.colorSpace 只讀: 一個字串，指示影像資料的顏色空間。
ImageData.height 只讀: 一個 unsigned long，表示 ImageData 的實際高度（以畫素為單位）。
ImageData.width 只讀: 一個 unsigned long，表示 ImageData 的實際寬度（以畫素為單位）。
ImageData.pixelFormat 只讀實驗性的: 一個字串，指示用於 ImageData 的格式。

規範
HTML # imagedata

本頁面最後修改於 ⁨2025年8月19日⁩，由 MDN 貢獻者修改。