ImageBitmapRenderingContext: transferFromImageBitmap() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Januar 2020⁩.

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