WebGLRenderingContext: bindFramebuffer() метод

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Примечание: Эта функция доступна в Web Workers.

Метод WebGLRenderingContext.bindFramebuffer() из WebGL API связывает предоставленный WebGLFramebuffer с указанным целевым объектом, или, если аргумент framebuffer равен null, — стандартный WebGLFramebuffer, ассоциированный с контекстом отрисовки холста.

Синтаксис

bindFramebuffer(target, framebuffer)

Параметры

target

GLenum значение, определяющее точку привязки (целевой объект). Возможные значения:

gl.FRAMEBUFFER: Объект хранения буфера данных для цветовых, альфа-, глубинных и шаблоновых буферов, используемый как место назначения для отрисовки и как источник для чтения (см. ниже).

При использовании контекста WebGL 2, доступны следующие значения:

gl.DRAW_FRAMEBUFFER: Используется как место назначения для операций отрисовки, таких как gl.draw*, gl.clear* и gl.blitFramebuffer.
gl.READ_FRAMEBUFFER: Используется как источник для операций чтения, таких как gl.readPixels и gl.blitFramebuffer.

framebuffer

Объект WebGLFramebuffer, который нужно привязать, или null для привязки HTMLCanvasElement или OffscreenCanvas объекта, связанного с контекстом отрисовки.

Возвращаемое значение

None (undefined).

Исключения

Возникает ошибка gl.INVALID_ENUM если target не является gl.FRAMEBUFFER, gl.DRAW_FRAMEBUFFER, или gl.READ_FRAMEBUFFER.

Примеры

Привязка буфера кадра

const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const framebuffer = gl.createFramebuffer();

gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);

Получение текущих привязок

Чтобы проверить текущую привязку буфера кадра, запросите константу FRAMEBUFFER_BINDING.

gl.getParameter(gl.FRAMEBUFFER_BINDING);

Спецификации

Спецификация
Спецификация WebGL # 5.14.6
Спецификация WebGL 2.0 # 3.7.1

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`bindFramebuffer`	9	12	4	12	5.1	25	4	12	8	1.5	4.4.3

См. также

WebGLRenderingContext.createFramebuffer()
WebGLRenderingContext.deleteFramebuffer()
WebGLRenderingContext.isFramebuffer()
Другие буферы: WebGLBuffer, WebGLRenderbuffer

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bindFramebuffer