XRDepthInformation: rawValueToMeters 属性

实验性: 这是一种 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在一些或所有 支持的浏览器中可用。

XRDepthInformation 接口的只读rawValueToMeters属性包含一个比例因子,用于将原始深度值乘以该因子才能获得以米为单位的深度。

对于 CPU 深度信息,请参阅 XRCPUDepthInformation.getDepthInMeters() 方法。

一个数字。

示例

使用 XRFrame.getDepthInformation()(CPU)或 XRWebGLBinding.getDepthInformation()(WebGL)获取深度信息。返回的对象将包含rawValueToMeters比例因子,可用于进一步计算。

对于 CPU 深度信息和格式为“luminance-alpha”的缓冲区

js
const uint16 = new Uint16Array(depthInfo.data);
const index = column + row * depthInfo.width;
const depthInMeters = uint16[index] * depthInfo.rawValueToMeters;

(对于“float32”数据格式,请使用 Float32Array。)

请注意,以米为单位的深度位于深度缓冲区坐标中。需要采取额外的步骤才能将它们转换为标准化的视图坐标,或者可以使用 XRCPUDepthInformation.getDepthInMeters() 方法。

规范

规范
WebXR 深度感知模块
# dom-xrdepthinformation-rawvaluetometers

浏览器兼容性

BCD 表格仅在浏览器中加载