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 を返します。

構文

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 ofnone,premultiply, ordefault (default).

colorSpaceConversion

Specifies whether the image should be decoded using color space conversion.Eithernone ordefault (default).The valuedefault indicates that implementation-specific behavior is used.

resizeWidth