XRCompositionLayer:layout 属性

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

XRCompositionLayer 接口的只读 layout 属性是图层的布局类型。

要指定图层的布局类型,请使用其中一种图层创建方法及其 layout 选项

字符串。可能的值

默认

图层可容纳会话的所有视图。建议为 default 布局使用 texture-array 纹理类型。

单声道

分配单个 XRSubImage 并将其呈现到双眼。

立体声

用户代理决定如何分配 XRSubImage(一个或两个)以及布局(顶部/底部或左侧/右侧)。建议为 stereo 布局使用 texture-array 纹理类型。

立体声-左右

分配单个 XRSubImage。左眼获得纹理的左侧区域,右眼获得右侧区域。此布局旨在针对已处于立体声状态的内容(例如立体声视频或图像)最小化绘制调用。

立体声-上下

分配单个 XRSubImage。左眼获得纹理的顶部区域,右眼获得底部区域。此布局旨在针对已处于立体声状态的内容(例如立体声视频或图像)最小化绘制调用。

示例

设置和获取图层的布局

要指定图层的布局,请使用图层创建方法(例如 XRWebGLBinding.createQuadLayer())及其 layout 选项。要检索图层布局的类型,请使用 layout 属性

js
const layer = xrGlBinding.createQuadLayer({
  pixelWidth: 1024,
  pixelHeight: 768,
  layout: "stereo",
});

layer.layout; // "stereo"

规范

规范
WebXR 图层 API 第 1 级
# dom-xrcompositionlayer-layout

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅