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 2021年9月.

* Some parts of this feature may have varying levels of support.

メモ: この機能はウェブワーカー内でのみ利用可能です。

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

構文

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

引数

image

画像ソースで、以下のうちの何れかです。

ImageBitmap が抽出される長方形の参照点の x 座標。

ImageBitmap が抽出される長方形の参照点の y 座標。

ImageBitmap が抽出される長方形の幅。この値は負の値にすることができます。

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, or default (default).

colorSpaceConversion

Specifies whether the image should be decoded using color space conversion. Either none or default (default). The value default indicates 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, or high.