WorkerGlobalScope: createImageBitmap() 方法

Baseline 廣泛可用 *

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

* 此特性的某些部分可能存在不同級別的支援。

注意:此功能僅在 Web Workers 中可用。

WorkerGlobalScope 介面的 createImageBitmap() 方法可從給定的源建立點陣圖,並可選擇性地裁剪該源以僅包含其中一部分。它接受各種不同的影像源,並返回一個 Promise,該 Promise 會解析為一個 ImageBitmap 物件。

語法

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

引數

圖片

一個影像源,可以是以下任意一種:

sx

將從其中提取 ImageBitmap 的矩形的參考點的 x 座標。

sy

將從其中提取 ImageBitmap 的矩形的參考點的 y 座標。

sw

將從其中提取 ImageBitmap 的矩形的寬度。此值可以是負數。

sh

將從其中提取 ImageBitmap 的矩形的高度。此值可以是負數。

options 可選

一個物件,用於設定影像提取的選項。可用的選項包括:

imageOrientation

指定點陣圖影像應如何定向。

from-image

根據 EXIF 方向元資料(如果存在)定向影像(預設)。

flipY

根據 EXIF 方向元資料(如果存在)定向影像,然後將其垂直翻轉。

none

根據影像編碼定向影像,忽略有關方向的任何元資料(例如,可能新增到影像中的 EXIF 元資料,以指示相機側向旋轉以以縱向模式拍攝影像)。

premultiplyAlpha

指定是否應將點陣圖的顏色通道乘以 alpha 通道。可以是 nonepremultiplydefault(預設)。

colorSpaceConversion

指定是否應使用顏色空間轉換來解碼影像。可以是 nonedefault(預設)。值 default 表示使用特定於實現的行為。

resizeWidth

一個長整數,表示輸出寬度。

resizeHeight

一個長整數,表示輸出高度。

resizeQuality

指定用於將輸入調整到匹配輸出尺寸的演算法。可以是 pixelatedlow(預設)、mediumhigh

返回值

一個 Promise,該 Promise 會解析為一個 ImageBitmap 物件,其中包含來自給定矩形的點陣圖資料。

示例

有關示例,請參閱 Window.createImageBitmap()

規範

規範
HTML
# dom-createimagebitmap-dev

瀏覽器相容性

另見