XREquirectLayer

XREquirectLayer gehört zum Modul WebXR Layers der WebXR Device API. Die Schicht erwartet eine Textur in equirektangulärer Projektion. Das ist das übliche Format für 360°- und 180°-Panoramen, meist mit einem Seitenverhältnis von 2:1 (360°) oder 1:1 (180°). Die Textur rendert nicht Ihre Anwendung in eine Kugel-Geometrie, sondern der Kompositor des XR-Geräts projiziert sie selbst auf die Innenseite einer Kugel. Dabei tastet er die Textur nur einmal ab und passt die Darstellung direkt vor der Anzeige an die aktuelle Kopfhaltung an. Das Ergebnis ist meist schärfer, flimmert weniger und ruckelt kaum, auch wenn die Anwendung Frames auslässt.

Einen Konstruktor gibt es nicht. Eine WebGL-gestützte Instanz erzeugen Sie mit XRWebGLBinding.prototype.createEquirectLayer(init), eine videogestützte mit XRMediaBinding.prototype.createEquirectLayer(video, init). Danach übergeben Sie die Schicht mit XRSession.prototype.updateRenderState({ layers: [...] }) an die Sitzung. Bei WebGL-Schichten schreiben Sie die Pixel in die Farbtextur, die XRWebGLBinding.prototype.getSubImage(layer, frame) liefert. Dynamische Inhalte zeichnen Sie in jedem Frame neu. Statische Schichten (isStatic: true) zeichnen Sie einmal und dann erst wieder, wenn needsRedraw auf true steht oder das Ereignis redraw eintritt.

Eigene Eigenschaften (alle beschreibbar):

• space (XRSpace): Referenzraum, an dem die Kugel verankert ist.
• transform (XRRigidTransform): Position und Ausrichtung des Kugelmittelpunkts relativ zu space.
• radius (number): Kugelradius in Metern. Bei 0 liegt die Kugel unendlich weit entfernt, es gibt also keine Parallaxe.
• centralHorizontalAngle (number): horizontaler Öffnungswinkel im Bogenmaß, Standard 2π.
• upperVerticalAngle / lowerVerticalAngle (number): obere und untere Grenze im Bogenmaß, Standard π/2 bzw. -π/2.

Von XRCompositionLayer erbt die Schnittstelle layout, mipLevels, needsRedraw, blendTextureSourceAlpha, forceMonoPresentation und destroy(). Von XRLayer und EventTarget kommt die Ereignisbehandlung, etwa für redraw über addEventListener("redraw", …) oder die Eigenschaft onredraw. Typische Einsatzfälle sind Panorama-Betrachter, 360°-Videos, Skyboxen und Hintergründe für Menüs in immersiven Sitzungen.