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

浏览器兼容性

另见