ImageBitmapRenderingContext.transferFromImageBitmap()

Nuestros voluntarios aún no han traducido este artículo al Español. ¡Únete a nosotros y ayúdanos a traducirlo!
También puedes leer el artículo en English (US).

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ImageBitmapRenderingContext.transferFromImageBitmap() method displays the given ImageBitmap in the canvas associated with this rendering context. The ownership of the ImageBitmap is transferred to the canvas as well.

This method was previously named transferImageBitmap(), but was renamed in a spec change. The old name is being kept as an alias to avoid code breakage.

Syntax

void ImageBitmapRenderingContext.transferFromImageBitmap(bitmap)

Parameters

bitmap
An ImageBitmap object to transfer.

Examples

HTML

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

JavaScript

var htmlCanvas = document.getElementById("htmlCanvas").getContext("bitmaprenderer");

// Draw a WebGL scene offscreen
var offscreen = new OffscreenCanvas(256, 256);
var gl = offscreen.getContext("webgl");

// ... some drawing using the gl context ...

// Transfer the current frame to the visible canvas
var bitmap = offscreen.transferToImageBitmap();
htmlCanvas.transferFromImageBitmap(bitmap);

Specifications

Currently drafted as a proposal: OffscreenCanvas.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
ExperimentalNon-standard
Chrome Full support 66Edge ? Firefox Full support 52
Full support 52
No support 46 — 52
Alternate Name
Alternate Name Uses the non-standard name: transferImageBitmap
IE No support NoOpera ? Safari No support NoWebView Android Full support 66Chrome Android Full support 66Edge Mobile ? Firefox Android Full support 52
Full support 52
No support 46 — 52
Alternate Name
Alternate Name Uses the non-standard name: transferImageBitmap
Opera Android ? Safari iOS ? Samsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Uses a non-standard name.
Uses a non-standard name.

See also

Etiquetas y colaboradores del documento

Colaboradores en esta página: fanmingfei, fscholz, chrisdavidmills
Última actualización por: fanmingfei,