XRDepthInformation
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The XRDepthInformation interface contains information about the distance from the user’s device to the real-world geometry in the user’s environment.
This interface is the parent of:
XRCPUDepthInformation-
Depth information from the CPU (returned by
XRFrame.getDepthInformation()). XRWebGLDepthInformation-
Depth information from WebGL (returned by
XRWebGLBinding.getDepthInformation()).
You will usually interact with these child interfaces. However, XRDepthInformation provides some useful properties that are inherited:
Properties
-
XRDepthInformation.heightRead only -
Contains the height of the depth buffer (number of rows).
-
XRDepthInformation.normDepthBufferFromNormViewRead only -
An
XRRigidTransformthat needs to be applied when indexing into the depth buffer. The transformation that the matrix represents changes the coordinate system from normalized view coordinates to normalized depth-buffer coordinates that can then be scaled by depth buffer’swidthandheightto obtain the absolute depth-buffer coordinates. -
XRDepthInformation.rawValueToMetersRead only -
Contains the scale factor by which the raw depth values must be multiplied in order to get the depths in meters.
-
XRDepthInformation.widthRead only -
Contains the width of the depth buffer (number of columns).
Methods
None.
Examples
See XRCPUDepthInformation and XRWebGLDepthInformation for code examples.
Specifications
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
XRDepthInformation |
90 |
90 |
No |
No |
76 |
No |
No |
90 |
No |
No |
No |
No |
height |
90 |
90 |
No |
No |
76 |
No |
No |
90 |
No |
No |
No |
No |
normDepthBufferFromNormView |
90 |
90 |
No |
No |
76 |
No |
No |
90 |
No |
No |
No |
No |
rawValueToMeters |
90 |
90 |
No |
No |
76 |
No |
No |
90 |
No |
No |
No |
No |
width |
90 |
90 |
No |
No |
76 |
No |
No |
90 |
No |
No |
No |
No |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XRDepthInformation