XRWebGLLayer: свойство framebuffer

Только для чтения XRWebGLLayer свойство framebuffer представляет собой невидимый WebGLFramebuffer, который используется для буферизации отрендеренного изображения, если используется XR композер. В противном случае, значение этого свойства null. Непрозрачный буфер кадров функционально практически идентичен стандартному буферу кадров WebGL, за исключением различий, описанных в разделе Как непрозрачные буферы кадров отличаются ниже.

Объект WebGLFramebuffer, представляющий буфер кадров, в который рендерится 3D сцена, или null, если XR композер отключён для сеанса.

Буфер кадров, представленный свойством framebuffer, является непрозрачным. В связи с этим его поведение отличается от стандартного контекста WebGL по нескольким параметрам. Эти различия заставляют непрозрачный буфер кадров вести себя больше как стандартный буфер кадров WebGL:

• Непрозрачные буферы кадров могут поддерживать антиалиасинг, даже в WebGL 1.0, что обычно не так.
• Прикрепления (буферы и т. п.) непрозрачных буферов кадров нельзя инспектировать или изменять. Вызов функций, таких как framebufferTexture2D(), framebufferRenderbuffer(), deleteFramebuffer() или getFramebufferAttachmentParameter(), для непрозрачного буфера кадров приводит к ошибке WebGL INVALID_OPERATION (0x0502).
• Непрозрачные буферы кадров считаются неполными и недоступны для рендеринга, кроме как во время выполнения обратного вызова requestAnimationFrame(). Попытка очистки, рисования в или считывания из буфера кадров приводит к ошибке WebGL INVALID_FRAMEBUFFER_OPERATION (0x0506). Вызов checkFramebufferStatus() в контексте WebGL извне обратного вызова анимационного кадра приводит к сообщению об ошибке WebGL FRAMEBUFFER_UNSUPPORTED (0x8CDD).
• Непрозрачные буферы кадров, инициализированные со свойством depth установленным на false, не будут иметь буфера глубины и будут полагаться только на координаты для определения расстояния.
• Непрозрачные буферы кадров, инициализированные без указания свойства stencil, не будут иметь буфера трафарета.
• Непрозрачные буферы кадров не будут иметь доступного альфа-канала, если свойство alpha не установлено в значение true при создании слоя.
• XR композер предполагает, что непрозрачные буферы кадров используют цвета с преумноженным альфа-каналом, независимо от того, установлено ли контекстное свойство WebGL premultipliedAlpha.

При создании нового XRWebGLLayer, его новый буфер кадров инициализируется так же, как и буфер кадров по умолчанию для любого интерфейса WebGL:

• Буфер цвета настроен со значением очистки (0, 0, 0, 0) (что означает прозрачный черный).
• Значение очистки буфера глубины — число 1.0.
• Буфер трафарета заполнен 0.

В этом примере берётся XRWebGLLayer для сеанса, а затем его буфер кадров передаётся в функцию bindFramebuffer() контекста WebGL.

let glLayer = xrSession.renderState.baseLayer;
gl.bindFramebuffer(gl.FRAMEBUFFER, glLayer.framebuffer);

• API устройства WebXR