XRCubeLayer: `redraw`-Ereignis

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 vor der Verwendung auf produktiven Webseiten.

Das redraw-Ereignis wird an das XRCubeLayer-Objekt gesendet, wenn die zugrunde liegenden Ressourcen der Schicht verloren gehen oder wenn der XR Kompositor die Schicht nicht mehr reprojizieren kann. Wenn dieses Ereignis gesendet wird, sollten Entwickler den Inhalt der Schicht im nächsten XR-Animationsrahmen neu zeichnen.

Siehe auch die XRCompositionLayer.needsRedraw-Eigenschaft, die über die Vererbung von XRCompositionLayer auch für XRCubeLayer-Objekte verfügbar ist.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
addEventListener("redraw", (event) => { })

onredraw = (event) => { }

Ereignistyp

Ein XRLayerEvent. Erbt von Event.

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.

layer Schreibgeschützt

Das XRLayer, das das Ereignis generiert hat.

Beispiele

Verwendung des redraw-Ereignisses

Sie können redraw an addEventListener() übergeben:

js
cubeLayer.addEventListener("redraw", (event) => {
  // redraw the layer
});

Alternativ können Sie die onredraw-Ereignis-Handler-Eigenschaft verwenden, um einen Handler für das redraw-Ereignis festzulegen:

js
cubeLayer.onredraw = (event) => {
  // redraw the layer
};

Spezifikationen

Specification
WebXR Layers API Level 1
# dom-xrcubelayer-onredraw

Browser-Kompatibilität

Siehe auch