ImageBitmapRenderingContext: transferFromImageBitmap() メソッド

メモ: この機能はウェブワーカー内で利用可能です。

ImageBitmapRenderingContext.transferFromImageBitmap() メソッドは、指定された ImageBitmap をこのレンダリングコンテキストに関連付けられたキャンバスで表示します。ImageBitmap の所有権はキャンバスにも移譲されます。

このメソッドは以前は transferImageBitmap() と名付けられていましたが、仕様変更で名前が変更されました。コードの破損を避けるため、古い名前は別名として残されています。

構文

js
transferFromImageBitmap(bitmap)

引数

bitmap

移譲 ImageBitmap オブジェクトです。

返値

なし (undefined)。

例

HTML

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

JavaScript

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

// WebGL シーンをオフスクリーンで描画
const offscreen = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("webgl");

// gl コンテキストを使用して何かを描画

// 現在のフレームを可視キャンバスに移譲
const bitmap = offscreen.transferToImageBitmap();
htmlCanvas.transferFromImageBitmap(bitmap);

仕様書

Specification
HTML Standard
# dom-imagebitmaprenderingcontext-transferfromimagebitmap-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報