canvas | метод transferControlToOffscreen()

canvas | метод transferControlToOffscreen()

Для веб-разработчиков (не нормативно)

canvas.transferControlToOffscreen()

Возвращает только что созданный объект OffscreenCanvas, который использует элемент холста canvas в качестве заполнителя. После того, как элемент холста canvas стал заполнителем для объекта OffscreenCanvas, его внутренний размер больше не может быть изменен, и он не может иметь контекст визуализации. Содержимое холста-заполнителя обновляется путем вызова метода commit() контекста визуализации объекта OffscreenCanvas.

 

Метод transferControlToOffscreen() при вызове должен выполнять следующие шаги:

1. Если для режима контекста этого элемента холста canvas не задано значение «none», вызовите исключение DOMException «InvalidStateError».
2. Пусть offscreenCanvas будет новым объектом OffscreenCanvas с шириной и высотой, равными значениям атрибутов содержимого ширины width и высоты height этого элемента холста canvas.
3. Установите элемент холста canvas заполнителя для offscreenCanvas как слабую ссылку на этот элемент холста canvas.
4. Установите контекстный режим этого элемента холста canvas на заполнитель.
5. Верните offscreenCanvas.

 

Информационные ссылки

Стандарт HTML — Раздел «The transferControlToOffscreen() method» — https://html.spec.whatwg.org/multipage/canvas.html#dom-canvas-transfercontroltooffscreen