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

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte transform-Eigenschaft des XRView-Interfaces ist ein XRRigidTransform-Objekt, das die Position und Orientierung des Blickpunkts relativ zum XRReferenceSpace angibt, das angegeben wurde, als die Methode XRFrame.getViewerPose() aufgerufen wurde, um das View-Objekt zu erhalten.

Mit dem transform können Sie dann die Ansicht als Kamera innerhalb der 3D-Szene positionieren. Wenn Sie stattdessen die traditionellere View-Matrix benötigen, können Sie diese mit view.transform.inverse.matrix erhalten; dies liefert die zugrunde liegende matrix der inverse des Transforms.

Wert

Ein XRRigidTransform-Objekt, das die Position und Orientierung des durch das XRView dargestellten Blickpunkts angibt.

Beispiele

Für jede Ansicht, die die dargestellte Szene bildet, repräsentiert das transform der Ansicht die Position und Orientierung des Betrachters oder der Kamera relativ zum Ursprung des Referenzraums. Sie können dann die Inverse dieser Matrix verwenden, um die Objekte in Ihrer Szene zu transformieren, um ihre Platzierung und Orientierung anzupassen und die Bewegung des Betrachters durch den Raum zu simulieren.

In diesem Beispiel sehen wir einen Umriss eines Codeausschnitts, der während des Renderns eines XRFrame verwendet wird und der das View-Transform verwendet, um Objekte während des Renderings in der Welt zu platzieren.

js
const modelViewMatrix = mat4.create();
const normalMatrix = mat4.create();

for (const view of pose.views) {
  const viewport = glLayer.getViewport(view);
  gl.viewport(viewport.x, viewport.y, viewport.width, viewport.height);

  for (const obj of world.objects) {
    mat4.multiply(modelViewMatrix, view.transform.inverse.matrix, obj.matrix);
    mat4.invert(normalMatrix, modelViewMatrix);
    mat4.transpose(normalMatrix, normalMatrix);

    obj.render(modelViewMatrix, normalMatrix);
  }
}

Zwei Matrizen werden außerhalb der Render-Schleife erstellt; dies vermeidet das wiederholte Allokieren und Deallokieren der Matrizen und reduziert im Allgemeinen den Overhead, indem dieselbe Matrix für jedes gerenderte Objekt wiederverwendet wird.

Dann iterieren wir über jedes XRView in der Liste der views von XRViewerPose. In der Regel gibt es zwei: eines für das linke Auge und eines für das rechte, aber es kann auch nur eines sein, wenn der monokulare Modus aktiviert ist. Derzeit unterstützt WebXR nicht mehr als zwei Ansichten pro Pose, obwohl Raum für die Erweiterung der Spezifikation gelassen wurde, um dies in Zukunft mit einigen Ergänzungen zur API zu unterstützen.

Für jede Ansicht erhalten wir ihren Viewport und übergeben diesen mit gl.viewport() an WebGL. Für das linke Auge wird dies die linke Hälfte der Leinwand sein, während das rechte Auge die rechte Hälfte verwendet.

Dann iterieren wir über jedes Objekt, das die Szene bildet. Die Model-View-Matrix jedes Objekts wird berechnet, indem seine eigene Matrix, die die eigene Position und Orientierung des Objekts beschreibt, mit den zusätzlichen Position- und Orientierungsanpassungen multipliziert wird, die erforderlich sind, um die Bewegung der Kamera nachzuvollziehen. Um die "kamera-fokussierte" Transform-Matrix in eine "objekt-fokussierte" zu konvertieren, verwenden wir die Inverse des Transforms, indem wir die Matrix nehmen, die von view.transform.inverse.matrix geliefert wird. Die resultierende Model-View-Matrix wird alle benötigten Transformationen anwenden, um das Objekt basierend auf den relativen Positionen des Objekts und der Kamera zu bewegen und zu rotieren. Dies simuliert die Bewegung der Kamera, obwohl wir tatsächlich das Objekt bewegen.

Wir berechnen dann die Normalen für die Model-View-Matrix, indem wir sie invertieren und dann transponieren.

Schließlich rufen wir die render()-Routine des Objekts auf, wobei wir die modelViewMatrix und normalMatrix übergeben, damit der Renderer das Objekt korrekt platzieren und beleuchten kann.

Hinweis: Dieses Beispiel ist aus einem größeren Beispiel abgeleitet... <<<--- finish and add link --->>>

Spezifikationen

Specification
WebXR Device API
# dom-xrview-transform

Browser-Kompatibilität

BCD tables only load in the browser