ImageBitmapRenderingContext: transferFromImageBitmap() Methode

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

Die ImageBitmapRenderingContext.transferFromImageBitmap() Methode zeigt das angegebene ImageBitmap im Canvas an, das mit diesem Rendering-Kontext verbunden ist. Der Besitz des ImageBitmap wird ebenfalls auf das Canvas übertragen.

Diese Methode hieß zuvor transferImageBitmap(), wurde jedoch in einer Spezifikationsänderung umbenannt. Der alte Name wird als Alias beibehalten, um Code-Brüche zu vermeiden.

Syntax

js
transferFromImageBitmap(bitmap)

Parameter

bitmap

Ein ImageBitmap-Objekt, das übertragen werden soll.

Rückgabewert

Kein (undefined).

Beispiele

HTML

html
<canvas id="htmlCanvas"></canvas>

JavaScript

js
const htmlCanvas = document
  .getElementById("htmlCanvas")
  .getContext("bitmaprenderer");

// Draw a WebGL scene offscreen
const offscreen = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("webgl");

// Perform some drawing using the gl context

// Transfer the current frame to the visible canvas
const bitmap = offscreen.transferToImageBitmap();
htmlCanvas.transferFromImageBitmap(bitmap);

Spezifikationen

Specification
HTML Standard
# dom-imagebitmaprenderingcontext-transferfromimagebitmap-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch