XRCompositionLayer: needsRedraw 属性

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

XRCompositionLayer 接口的只读 needsRedraw 属性是一个布尔值,表示该层是否应该在下一帧重新渲染。

当层的底层资源由于纹理(可能已被合成器在幕后释放)丢失时,可能会需要重新绘制。当设备进入休眠状态或浏览器切换上下文(到操作系统对话框或类似内容)然后恢复时,可能会发生这种情况。

对于每帧更新的层,重新绘制不是问题。但是,对于不经常更新的层或静态层(您只能在创建后或在 redraw 事件后绘制一次),层的内容可能会丢失并需要重新绘制。如果层的资源丢失,needsRedraw 属性将为 true,并且会在该层上触发 redraw 事件。

一个布尔值。true 表示在下一帧需要重新渲染,false 表示不需要重新渲染。

示例

重新绘制层

使用 needsRedraw 属性检查层是否需要重新绘制,然后重新绘制它。

js
function onXRFrame(time, frame) {
  // …

  if (quadLayer.needsRedraw) {
    // redraw the layer
  }
}

规范

规范
WebXR Layers API 级别 1
# dom-xrcompositionlayer-needsredraw

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅