WebGLRenderingContext: метод checkFramebufferStatus()

Базовая реализация Широко доступна

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

Примечание: Данная функция доступна в рабочих потоках.

Метод WebGLRenderingContext.checkFramebufferStatus() API WebGL возвращает статус готовности объекта WebGLFramebuffer.

Синтаксис

checkFramebufferStatus(target)

Параметры

target

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

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

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

gl.DRAW_FRAMEBUFFER: Эквивалентно gl.FRAMEBUFFER. Используется в качестве целевого объекта для отрисовки, рендеринга, очистки и записи.
gl.READ_FRAMEBUFFER: Используется в качестве источника для операций чтения.

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

Значение типа GLenum, указывающее на готовность фреймбуфера, или 0 в случае ошибки. Возможные значения перечисления:

gl.FRAMEBUFFER_COMPLETE: Фреймбуфер готов к отображению.
gl.FRAMEBUFFER_INCOMPLETE_ATTACHMENT: Типы прикрепленных объектов несовместимы или не все точки прикрепления фреймбуфера завершены.
gl.FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT: Отсутствует прикрепление.
gl.FRAMEBUFFER_INCOMPLETE_DIMENSIONS: Высота и ширина прикрепления не совпадают.
gl.FRAMEBUFFER_UNSUPPORTED: Формат прикрепления не поддерживается или если прикрепления глубины и маски не являются одним и тем же рендеринг-буфером.
При использовании контекста WebGL 2, могут быть возвращены следующие дополнительные значения:
- gl.FRAMEBUFFER_INCOMPLETE_MULTISAMPLE: Значения gl.RENDERBUFFER_SAMPLES отличаются между прикрепленными рендеринг-буферами, или отличны от нуля, если прикрепленные изображения представляют собой смесь рендеринг-буферов и текстур.
При использовании расширения OVR_multiview2, может быть возвращено следующее дополнительное значение:
- ext.FRAMEBUFFER_INCOMPLETE_VIEW_TARGETS_OVR: Если baseViewIndex не одинаково для всех точек прикрепления фреймбуфера, где значение FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE не равно NONE, фреймбуфер считается неполным.

Примеры

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

// …

gl.checkFramebufferStatus(gl.FRAMEBUFFER);

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`checkFramebufferStatus`	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/checkFramebufferStatus