XRCompositionLayer: needsRedraw-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die schreibgeschützte needsRedraw-Eigenschaft der XRCompositionLayer-Schnittstelle ist ein boolescher Wert, der signalisiert, dass die Ebene im nächsten Frame neu gerendert werden soll.

Das Bedürfnis nach Neuzeichnung kann auftreten, wenn die zugrunde liegenden Ressourcen einer Ebene verloren gehen, da Texturen möglicherweise im Hintergrund vom Kompositor freigegeben wurden. Dies könnte passieren, wenn das Gerät in den Schlafmodus geht oder wenn der Browser den Kontext wechselt (zu einem Betriebssystem-Dialog oder ähnlichem) und dann zurückkommt.

Das Neuzeichnen ist kein Problem für Ebenen, die mit jedem Frame aktualisiert werden. Für Ebenen, die selten aktualisiert werden, oder für statische Ebenen (bei denen Sie nur einmal nach der Erstellung oder nach einem redraw-Ereignis zeichnen können), könnten die Inhalte der Ebene verloren gehen und müssen neu gezeichnet werden. Wenn die Ressourcen der Ebene verloren gehen, wird die needsRedraw-Eigenschaft true und ein redraw-Ereignis wird auf der Ebene ausgelöst.

Wert

Ein boolescher Wert. true zeigt an, dass im nächsten Frame ein Neurendering erforderlich ist, false zeigt an, dass kein Neurendering erforderlich ist.

Beispiele

Ebenen neu zeichnen

Verwenden Sie die needsRedraw-Eigenschaft, um zu überprüfen, ob eine Ebene neu gezeichnet werden muss, und zeichnen Sie sie dann neu.

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

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

Spezifikationen

Specification
WebXR Layers API Level 1
# dom-xrcompositionlayer-needsredraw

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch