WorkerGlobalScope:createImageBitmap() 方法
备注: 此特性仅在 Web Worker 中可用。
WorkerGlobalScope
接口的 createImageBitmap
从给定的来源创建位图,也可以进行裁剪以包含源图像的一部分。它接受各种不同的图像来源,并返回一个会兑现 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
-
指定位图图像的方向。
from-image
-
如果存在 EXIF 方向元数据,则根据其来指定图像方向(默认)。
flipY
-
如果存在 EXIF 方向元数据,则根据其来指定图像方向,然后垂直翻转。
none
-
根据图像的编码来指定图像方向,忽略有关方向的任何元数据(例如,可能添加到图像中的 EXIF 元数据,以指示相机被转向以在人像模式下捕获图像)。
premultiplyAlpha
-
指定位图的颜色通道是否应与 alpha 通道预乘。以下值之一:
none
、premultiply
或default
(默认)。 colorSpaceConversion
-
指定图像是否应使用色彩空间转换进行解码。
none
或default
(默认)。default
值表示使用特定于实现的行为。 resizeWidth
-
指定输出宽度的长整数。
resizeHeight
-
指定输出高度的长整数。
resizeQuality
-
指定用于调整输入大小以匹配输出尺寸的算法。以下值之一:
pixelated
、low
(默认)、medium
或high
。
返回值
一个 Promise
,会兑现为一个包含给定矩形的位图数据的 ImageBitmap
对象。
示例
参见 Window.createImageBitmap()
以获取示例。
规范
Specification |
---|
HTML Standard # dom-createimagebitmap-dev |
浏览器兼容性
BCD tables only load in the browser