大网数据广告活动
Web 标准与前端开发

XRCompositionLayer: needsRedraw property

· 52CE 我爱测

The read-only **`needsRedraw`** property of the XRCompositionLayer interface is a boolean signaling that the layer should be re-rendered in the next frame.

WebXR Device API

The read-only needsRedraw property of the XRCompositionLayer interface is a boolean signaling that the layer should be re-rendered in the next frame.

The need for redrawing can occur when the underlying resources of a layer are lost due to textures that might have been freed by the compositor under the hood. This might happen when the device falls asleep or when the browser switches context (to an operating system dialog or similar) and then comes back.

Redrawing is not a problem for layers which are updated with every frame. However, for layers updated infrequently, or for static layers (where you can only draw once after creation or after a redraw event), the layer's content might be lost and need to be redrawn. If the layer's resources are lost, the needsRedraw property will be true and a redraw event is fired on the layer.

Value

A boolean. true indicates a rerendering is needed in the next frame, false indicates no re-rendering is needed.

Examples

Redrawing layers

Use the needsRedraw property to check if a layer needs to be redrawn and then redraw it.

function onXRFrame(time, frame) {
  // …

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

Specifications

Browser compatibility

See also

  • XREquirectLayer: XREquirectLayer.redraw_event event
  • XRCubeLayer: XRCubeLayer.redraw_event event
  • XRCylinderLayer: XRCylinderLayer.redraw_event event
  • XRQuadLayer: XRQuadLayer.redraw_event event

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。