WorkerGlobalScope: createImageBitmap() メソッド
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
* Some parts of this feature may have varying levels of support.
メモ: この機能はウェブワーカー内でのみ利用可能です。
createImageBitmap() は WorkerGlobalScope インターフェイスのメソッドで、指定されたソースからビットマップを作成し、オプションでそのソースの一部のみを切り抜きます。
このメソッドは、さまざまな画像ソースを受け付け、 ImageBitmap に解決する Promise を返します。
構文
createImageBitmap(image)
createImageBitmap(image, options)
createImageBitmap(image, sx, sy, sw, sh)
createImageBitmap(image, sx, sy, sw, sh, options)
引数
image-
画像ソースで、以下のうちの何れかです。
sx-
ImageBitmapが抽出される長方形の参照点の x 座標。 sy-
ImageBitmapが抽出される長方形の参照点の y 座標。 sw-
ImageBitmapが抽出される長方形の幅。 この値は負の値にすることができます。 sh-
ImageBitmapが抽出される長方形の高さ。この値は負の値にすることができます。 options省略可-
画像の抽出のためのオプションを設定するオブジェクト。利用可能なオプションは以下の通りです。
imageOrientation-
Specifies how the bitmap image should be oriented.
from-image-
EXIF 方向メタデータが存在する場合、その方向に従って画像を表示します（既定値）。
flipY-
EXIF 方向メタデータが存在する場合、そのメタデータに従って画像の方向を調整し、垂直方向に反転します。
none-
画像のエンコード方式に従って画像の方向を調整し、方向に関するメタデータ（EXIF メタデータなど、画像を縦向きで撮影するためにカメラを横向きにしたことを示すために画像に追加される場合のあるメタデータ）は無視します。
premultiplyAlpha-
Specifies whether the bitmap's color channels should be premultiplied by the alpha channel. One of
none,premultiply, ordefault(default). colorSpaceConversion-
Specifies whether the image should be decoded using color space conversion. Either
noneordefault(default). The valuedefaultindicates that implementation-specific behavior is used. resizeWidth-
A long integer that indicates the output width.
resizeHeight-
A long integer that indicates the output height.
resizeQuality-
Specifies the algorithm to be used for resizing the input to match the output dimensions. One of
pixelated,low(default),medium, orhigh.
返値
指定された長方形のビットマップデータを保持する ImageBitmap オブジェクトに解決する Promise を返します。
例
例については Window.createImageBitmap() を参照してください。
仕様書
| Specification |
|---|
| HTML # dom-createimagebitmap-dev |