ImageBitmapRenderingContext: transferFromImageBitmap() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

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

Die ImageBitmapRenderingContext.transferFromImageBitmap() Methode zeigt das angegebene ImageBitmap auf der mit diesem Rendering-Kontext verbundenen Leinwand an. Das Eigentum des ImageBitmap wird ebenfalls auf die Leinwand übertragen.

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

Syntax

transferFromImageBitmap(bitmap)

Parameter

bitmap: Ein ImageBitmap Objekt zum Übertragen oder null. Wenn der Wert null ist, wird die Leinwand auf leer zurückgesetzt.

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

JavaScript

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);