WorkerGlobalScope: createImageBitmap()-Methode

Hinweis: Diese Funktion ist nur in Web Workers verfügbar.

Die createImageBitmap()-Methode der WorkerGlobalScope-Schnittstelle erstellt ein Bitmap aus einer gegebenen Quelle, das optional zugeschnitten werden kann, um nur einen Teil dieser Quelle zu enthalten. Sie akzeptiert eine Vielzahl verschiedener Bildquellen und gibt ein Promise zurück, das zu einem ImageBitmap aufgelöst wird.

Syntax

js
createImageBitmap(image)
createImageBitmap(image, options)
createImageBitmap(image, sx, sy, sw, sh)
createImageBitmap(image, sx, sy, sw, sh, options)

Parameter

image

Eine Bildquelle, die eine der folgenden sein kann:

sx

Die x-Koordinate des Bezugspunkts des Rechtecks, aus dem das ImageBitmap extrahiert wird.

sy

Die y-Koordinate des Bezugspunkts des Rechtecks, aus dem das ImageBitmap extrahiert wird.

sw

Die Breite des Rechtecks, aus dem das ImageBitmap extrahiert wird. Dieser Wert kann negativ sein.

sh

Die Höhe des Rechtecks, aus dem das ImageBitmap extrahiert wird. Dieser Wert kann negativ sein.

options Optional

Ein Objekt, das Optionen für die Extraktion des Bildes festlegt. Die verfügbaren Optionen sind:

imageOrientation

Gibt an, wie das Bitmap-Bild ausgerichtet werden soll.

from-image

Bild wird entsprechend der EXIF-Orientierungsmetadaten ausgerichtet, falls vorhanden (Standard).

flipY

Bild wird entsprechend der EXIF-Orientierungsmetadaten ausgerichtet, falls vorhanden, und dann vertikal gespiegelt.

none

Bild wird entsprechend der Bildkodierung ausgerichtet, wobei alle Metadaten zur Ausrichtung ignoriert werden (wie EXIF-Metadaten, die einem Bild hinzugefügt werden könnten, um anzuzeigen, dass die Kamera gedreht wurde, um das Bild im Hochformat aufzunehmen).

premultiplyAlpha

Gibt an, ob die Farbkanäle des Bitmaps durch den Alphakanal vorgemischt werden sollen. Einer von none, premultiply oder default (Standard).

colorSpaceConversion

Gibt an, ob das Bild mithilfe der Farbraumkonvertierung dekodiert werden soll. Entweder none oder default (Standard). Der Wert default gibt an, dass ein implementierungsspezifisches Verhalten verwendet wird.

resizeWidth

Ein langer Integer, der die Ausgangsbreite angibt.

resizeHeight

Ein langer Integer, der die Ausgangshöhe angibt.

resizeQuality

Gibt den Algorithmus an, der verwendet werden soll, um die Eingabe so zu skalieren, dass sie den Ausgabedimensionen entspricht. Einer von pixelated, low (Standard), medium oder high.

Rückgabewert

Ein Promise, das zu einem ImageBitmap-Objekt aufgelöst wird, das Bitmap-Daten aus dem angegebenen Rechteck enthält.

Beispiele

Siehe Window.createImageBitmap() für Beispiele.

Spezifikationen

Specification
HTML Standard
# dom-createimagebitmap-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch