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 |
浏览器兼容性
加载中…