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