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.
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
XREquirectLayer
:redraw
-EreignisXRCubeLayer
:redraw
-EreignisXRCylinderLayer
:redraw
-EreignisXRQuadLayer
:redraw
-Ereignis