ImageBitmapRenderingContext: transferFromImageBitmap() method

Baseline Widely available

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

Note: This feature is available in Web Workers.

Phương thức ImageBitmapRenderingContext.transferFromImageBitmap() hiển thị ImageBitmap đã cho trong canvas liên kết với ngữ cảnh kết xuất này. Quyền sở hữu ImageBitmap cũng được chuyển cho canvas.

Phương thức này trước đây có tên là transferImageBitmap(), nhưng đã được đổi tên trong một thay đổi thông số kỹ thuật. Tên cũ được giữ lại như một bí danh để tránh phá vỡ code.

Cú pháp

js
transferFromImageBitmap(bitmap)

Tham số

bitmap

Một đối tượng ImageBitmap để chuyển, hoặc null. Nếu giá trị là null, canvas được đặt lại thành trống.

Giá trị trả về

Không có (undefined).

Ví dụ

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

Thông số kỹ thuật

Specification
HTML
# dom-imagebitmaprenderingcontext-transferfromimagebitmap-dev

Tương thích trình duyệt

Xem thêm