WorkerGlobalScope: createImageBitmap() 方法
Baseline 廣泛可用 *
注意:此功能僅在 Web Workers 中可用。
WorkerGlobalScope 介面的 createImageBitmap() 方法可從給定的源建立點陣圖,並可選擇性地裁剪該源以僅包含其中一部分。它接受各種不同的影像源,並返回一個 Promise,該 Promise 會解析為一個 ImageBitmap 物件。
語法
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 通道。可以是
none、premultiply或default(預設)。 colorSpaceConversion-
指定是否應使用顏色空間轉換來解碼影像。可以是
none或default(預設)。值default表示使用特定於實現的行為。 resizeWidth-
一個長整數,表示輸出寬度。
resizeHeight-
一個長整數,表示輸出高度。
resizeQuality-
指定用於將輸入調整到匹配輸出尺寸的演算法。可以是
pixelated、low(預設)、medium或high。
返回值
一個 Promise,該 Promise 會解析為一個 ImageBitmap 物件,其中包含來自給定矩形的點陣圖資料。
示例
有關示例,請參閱 Window.createImageBitmap()。
規範
| 規範 |
|---|
| HTML # dom-createimagebitmap-dev |
瀏覽器相容性
載入中…