Newly available 主要ブラウザで対応済みだが、古いバージョンでは未対応の場合がある。

createImageBitmap

createImageBitmap() は Window インターフェイスのメソッドで、指定されたソースからビットマップを作成し、オプションでそのソースの一部のみを切り抜きます。 このメソッドは、さまざまな画像ソースを受け付け、 ImageBitmap に解決する Promise を返します。

ファイル・クリップボード・ストリーム

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
createImageBitmap
50
79
42
15
50
15
options_colorSpaceConversion_parameter

`options.colorSpaceConversion` パラメータ
58
79
98
15
58
15
options_imageOrientation_parameter

`options.imageOrientation` パラメータ
52
79
93
15
52
15
options_imageOrientation_parameter (from-image)

`from-image` の値
112
112
111
16
112
16
options_premultiplyAlpha_parameter

`options.premultiplyAlpha` パラメータ
52
79
93
17
52
17
options_resizeHeight_parameter

`options.resizeHeight` パラメータ
54
79
98
15
54
15
options_resizeQuality_parameter

`options.resizeQuality` パラメータ
54
79
149
15
54
15
options_resizeWidth_parameter

`options.resizeWidth` パラメータ
54
79
98
15
54
15
svgimageelement_as_source_image

ソース画像としての`SVGImageElement`
59
79
65
17.2
59
17.2
ImageBitmap

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

ImageBitmap.close() メソッドは、ImageBitmap に関連するすべてのグラフィカルリソースを破棄します。
52
79
46
15
52
15
height

読み取り専用の ImageBitmap.height プロパティは、ImageBitmap オブジェクトの高さを CSS ピクセル数で返します。
50
79
42
15
50
15
width

読み取り専用の ImageBitmap.width プロパティは、 ImageBitmap オブジェクトの幅を CSS ピクセル数で返します。
50
79
42
15
50
15
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (17)
実装メモ
  • ソース画像が `ImageData` オブジェクトの場合、`premultiplyAlpha` オプションは何も行いません。バグ 237082 を参照してください。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (17)
実装メモ
  • ソース画像が `ImageData` オブジェクトの場合、`premultiplyAlpha` オプションは何も行いません。バグ 237082 を参照してください。

基本構文

JAVASCRIPT 
createImageBitmap(image)
createImageBitmap(image, options)
createImageBitmap(image, sx, sy, sw, sh)
createImageBitmap(image, sx, sy, sw, sh, options)

実務での使いどころ

  • createImageBitmap の活用

    createImageBitmap() は Window インターフェイスのメソッドで、指定されたソースからビットマップを作成し、オプションでそのソースの一部のみを切り抜きます。

注意点

  • 古いブラウザでは対応していない場合がある。

実装メモ

  • 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。

参考リンク