此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
WorkerGlobalScope：createImageBitmap() 方法
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021年9月.
* Some parts of this feature may have varying levels of support.
备注： 此特性仅在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 # dom-createimagebitmap-dev |