WorkerGlobalScope: createImageBitmap() Methode
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
* Some parts of this feature may have varying levels of support.
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. Es akzeptiert eine Vielzahl von unterschiedlichen Bildquellen und gibt ein Promise zurück, das sich zu einem ImageBitmap auflöst.
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
ImageBitmapextrahiert wird. sy-
Die y-Koordinate des Referenzpunkts des Rechtecks, aus dem das
ImageBitmapextrahiert wird. sw-
Die Breite des Rechtecks, aus dem das
ImageBitmapextrahiert wird. Dieser Wert kann negativ sein. sh-
Die Höhe des Rechtecks, aus dem das
ImageBitmapextrahiert wird. Dieser Wert kann negativ sein. optionsOptional-
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 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 hinzugefügt sein könnten, um anzugeben, dass die Kamera zur Aufnahme im Hochformat gedreht wurde).
premultiplyAlpha-
Gibt an, ob die Farbkanäle des Bitmaps mit dem Alphakanal vorvervielfacht werden sollen. Eine der Optionen
none,premultiplyoderdefault(Standard). colorSpaceConversion-
Gibt an, ob das Bild mithilfe einer Farbkonvertierung dekodiert werden soll. Entweder
noneoderdefault(Standard). Der Wertdefaultgibt 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),mediumoderhigh.
Rückgabewert
Ein Promise, das sich zu einem ImageBitmap-Objekt auflöst, das Bitmap-Daten aus dem angegebenen Rechteck enthält.
Beispiele
Siehe Window.createImageBitmap() für Beispiele.
Spezifikationen
| Specification |
|---|
| HTML # dom-createimagebitmap-dev |