WorkerGlobalScope: createImageBitmap() Methode

Baseline Weitgehend verfgbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit September 2021 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Hinweis: Diese Funktion ist nur in Web Workers verfgbar.

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. Es akzeptiert eine Vielzahl von unterschiedlichen Bildquellen und gibt ein Promise zurck, das sich zu einem ImageBitmap auflst.

Syntax

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 Referenzpunkts des Rechtecks, aus dem das ImageBitmap extrahiert wird.

sy

Die y-Koordinate des Referenzpunkts 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 Hhe des Rechtecks, aus dem das ImageBitmap extrahiert wird. Dieser Wert kann negativ sein.

options Optional

Ein Objekt, das Optionen fr die Extraktion des Bildes festlegt. Die verfgbaren Optionen sind:

imageOrientation

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

from-image: Bild gem EXIF-Ausrichtungsmetadaten ausgerichtet, falls vorhanden (Standard).
flipY: Bild gem EXIF-Ausrichtungsmetadaten ausgerichtet, falls vorhanden, und dann vertikal gespiegelt.
none: Bild anhand der Bildkodierung ausgerichtet, unter Ignorierung von Metadaten zur Ausrichtung (z. B. EXIF-Metadaten, die einem Bild hinzugefgt sein knnten, um anzugeben, dass die Kamera zur Aufnahme im Hochformat gedreht wurde).

premultiplyAlpha

Gibt an, ob die Farbkanle des Bitmaps mit dem Alphakanal vorvervielfacht werden sollen. Eine der Optionen none, premultiply oder default (Standard).

colorSpaceConversion

Gibt an, ob das Bild mithilfe einer Farbkonvertierung dekodiert werden soll. Entweder none oder default (Standard). Der Wert default gibt an, dass eine implementierungsspezifische Vorgehensweise verwendet wird.

resizeWidth

Eine ganze Zahl, die die Ausgabebreite angibt.

resizeHeight

Eine ganze Zahl, die die Ausgabebreite angibt.

resizeQuality

Gibt den Algorithmus an, der zum Anpassen der Eingabedaten an die Ausgabedimensionen verwendet wird. Eine der Optionen pixelated, low (Standard), medium oder high.