XRWebGLLayer: свойство ignoreDepthValues

Только для чтения XRWebGLLayer свойство ignoreDepthValues имеет значение типа Boolean, которое равно true если сеанс был настроен на игнорирование значений в буфере глубины во время отрисовки сцены. Если буфер глубины используется для определения положения вершин, это свойство равно false.

Значение ignoreDepthValues может быть установлено только при создании XRWebGLLayer, установив соответствующее значение в options параметре конструктора.

Значение типа Boolean, равное true если буфер глубины контекста WebGL используется при вычислении расположений точек в 3D-мире. В противном случае, если это true, значения буфера глубины используются для размещения объектов в сцене. Поскольку XR композитор по умолчанию использует буфер глубины, это значение равно false , если явно не задано иное при создании XRWebGLLayer с помощью его конструктора, XRWebGLLayer().

Когда свойство ignoreDepthValues имеет значение false, XR композитор использует значения, найденные в буфере глубины, которые должны быть точными для сцены, чтобы потенциально улучшить качество и комфортность для зрителя.

Ширина буфера глубины составляет framebufferWidth элементов, а высота — framebuffer элементов. Каждое значение в буфере указывает глубину, на которой находится соответствующий пиксель, и имеет значение от 0.0 до 1.0.

Значение пикселя буфера глубины 0.0 соответствует глубине, заданной depthNear сеанса, а значение 1.0 соответствует глубине, заданной depthFar.

Глубина в сочетании с координатами каждой отрисовываемой точки позволяет более точно представить сцену в 3D-пространстве.

Если веб-приложение, использующее WeXR, рендерит контент без использования буфера глубины — или если содержимое буфера глубины недействительно — вы должны отключить использование буфера глубины для рендеринга WebXR, установив ignoreDepthValues в значение true при создании XRWebGLLayer. Это демонстрируется в фрагменте кода ниже:

const glLayerOptions = {
  ignoreDepthValues: true,
};

let glLayer = new XRWebGLLayer(xrSession, gl, glLayerOptions);

• WebXR Device API
• Методы, связанные с буфером глубины WebGL: depthFunc(), clearDepth()