ImageBitmapRenderingContext: transferFromImageBitmap() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。
メモ: この機能はウェブワーカー内で利用可能です。
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);
仕様書
| 仕様書 |
|---|
| HTML> # dom-imagebitmaprenderingcontext-transferfromimagebitmap-dev> |
ブラウザーの互換性
関連情報
- このメソッドを定義するインターフェイスである
ImageBitmapRenderingContext OffscreenCanvasOffscreenCanvas.transferToImageBitmap()