DOM

インターフェイス

ImageBitmap インターフェイス

→●、MS（en）

このインターフェイスは、過度の遅延なしに<canvas>に描画できるビットマップ イメージを表します。createImageBitmap() ファクトリ メソッドを使用して、さまざまなソース オブジェクトから作成できます。ImageBitmapは、WebGLでレンダリングするためのテクスチャを準備するための非同期でリソース効率の高い経路を提供します。

プロパティ

ImageBitmap.height 読取専用 ●

ImageDataの高さをCSSピクセルで表す unsigned longです。

ImageBitmap.width 読取専用 ●

ImageDataの幅をCSSピクセルで表す unsigned longです。

メソッド

ImageBitmap.close() ●

ImageBitmap に関連付けられているすべてのグラフィカル リソースを破棄します。

promise= self.createImageBitmap(image[,options]) ●
promise=self.createImageBitmap(image,sx,sy,sw,sh[,options]) ●

所与の image から新たな ImageBitmap が作成された時点で解決される、promise を返す ― image は次のいずれかをとり得る：

img 要素 ／ SVG image 要素 ／ video 要素 ／ canvas 要素 ／ Blob オブジェクト ／ ImageData オブジェクト ／ 別の ImageBitmap オブジェクト

ImageBitmap オブジェクトを構築できなかった場合 ― 例えば、供された image データが実際には画像でなかったなど ― promise は却下される。

sx、sy、sw、sh 引数が供された場合、ソース画像は、それらが成す矩形に切り抜かれる ― 元の画像に無い画素は、透明な黒に置換される。これらの座標は、ソース画像のピクセル座標空間であり、CSS ピクセル数ではない。

options が供された場合、ImageBitmap オブジェクトのビットマップ･データは、options に則って改変される。例えば［options の premultiplyAlpha オプション ＝ "premultiply"］ならば、ビットマップ･データ の各色チャネルは、そのアルファ･チャンネルにより乗算済みにされる。

ソース画像の状態が妥当でない場合、promise は InvalidStateError で却下される ― 例えば：

• 成功裡に読み込まれなかった img 要素
• ImageBitmap オブジェクトであって［ [[Detached]] 内部スロット値 ＝ true ］なるもの
• ImageData オブジェクトであって［ data 属性値の [[ViewedArrayBuffer]] 内部スロットは detached【 IsDetachedBuffer( 内部スロットの値 ) ＝ true 】］なるもの
• Blob であって そのデータをビットマップ画像に解釈できないもの

スクリプトからソース画像の画像データへのアクセスは許容されない場合、promise は SecurityError 例外で却下される（例： CORS 非同一生成元の video／別の生成元からの worker 内のスクリプトにより描かれている canvas ）。

テスト