XRWebGLLayer.ignoreDepthValues

在此页

句法
用法注意事项
范例
规范
浏览器兼容性
另请参阅
相关话题

安全上下文
此特征只可用于安全上下文 (HTTPS)，在某些或所有支持浏览器 .

只读 XRWebGLLayer property ignoreDepthValues is a Boolean value which is true if the session has been configured to ignore the values in the depth buffer while rendering the scene. If the depth buffer is being used to determine the position of vertices, this property is false .

值 ignoreDepthValues can only be set when the XRWebGLLayer is instantiated, by setting the corresponding value in the XRWebGLLayerInit object specified as the constructor's layerInit parameter. As a parameter you're likely to set yourself, it is unlikely you'll need to read it later, but it's available if the need arises.

句法

let ignoringDepthBuffer = xrWebGLLayer.ignoreDepthValues;

值

A Boolean value which is true if the WebGL context's depth buffer is being used while computing the locations of points in the 3D world. Otherwise, if this is true , the depth buffer's values are being used to assist in placing objects in the scene. Since the XR compositor uses the depth buffer by default, this value is false unless explicitly set otherwise when creating the XRWebGLLayer using its constructor, XRWebGLLayer() .

用法注意事项

当 ignoreDepthValues 特性为 false , the XR compositor uses the values found in the depth buffer, which should be accurate for the scene, in order to potentially improve the quality or the output as well as the comfort level for the viewer.

The depth buffer is framebufferWidth entires wide and framebuffer entries tall. Each entry in the buffer specifies the depth at which the corresponding pixel is located, and has a value between 0.0 and 1.0.

A depth buffer pixel value of 0.0 corresponds to the depth given by the session's depthNear and a value of 1.0 corresponds to the depth given by depthFar .

The depth, in tandem with the coordinates of each point being rendered, makes it possible to more accurately represent the scene in the 3D space.

范例

If the Web application which is using WeXR is rendering its content without using a depth buffer—or if the depth buffer's contents are invalid—you should disable the use of the depth buffer for WebXR rendering by setting ignoreDepthValues to true when creating the XRWebGLLayer . This is demonstrated in the snippet of code below:

const glLayerOptions = {
  ignoreDepthValues: true
};
let glLayer = new XRWebGLLayer(xrSession, gl, glLayerOptions);

规范

规范	状态	注释
WebXR 设备 API The definition of 'XRWebGLLayer.ignoreDepthValues' in that specification.	工作草案	初始定义。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`ignoreDepthValues`	Chrome 79	Edge 79	Firefox No	IE No	Opera No	Safari No	WebView Android No	Chrome Android 79	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 11.2

图例

完整支持
不支持

另请参阅

WebXR 设备 API
WebGLLayerInit
WebGL depth buffer related methods: depthFunc() , clearDepth()

元数据

最后修改： Jan 13, 2020

WebXR 设备 API
XRWebGLLayer
构造函数
1. XRWebGLLayer()
特性
1. framebuffer
2. framebufferHeight
3. framebufferWidth
4. ignoreDepthValues
方法
1. getViewport()
Related pages for WebXR Device API

在此页

句法

值

用法注意事项

范例

规范

浏览器兼容性

图例

另请参阅

相关话题