files/en-us/web/api/xrrigidtransform/orientation/index.md
{{APIRef("WebXR Device API")}}{{SecureContext_Header}}
The read-only {{domxref("XRRigidTransform")}} property
orientation is a {{domxref("DOMPointReadOnly")}}
containing a normalized {{Glossary("quaternion")}} (also called a unit
quaternion or versor)
specifying the rotational component of the transform represented by the object.
If you specify a quaternion whose length is not exactly 1.0 meters, it will be
normalized for you.
A {{domxref("DOMPointReadOnly")}} object which contains a unit quaternion providing the orientation component of the transform. As a unit quaternion, the length of the returned quaternion is always 1.0 meters.
To create a reference space which is oriented to look straight up, positioned 2 meters off of ground level:
xrReferenceSpace = refSpace.getOffsetReferenceSpace(
new XRRigidTransform({ y: -2 }, { x: 0.0, y: 1.0, z: 0.0, w: 1.0 }),
);
The unit quaternion specified here is [0.0, 1.0, 0.0, 1.0] to indicate that the object should be facing directly along the y axis.
{{Specifications}}
{{Compat}}