The read-only XRRigidTransform
property orientation
is a DOMPointReadOnly
containing a normalized 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.
Syntax
let orientation = xrRigidTransform.orientation;
Value
A 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.
Examples
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
Specification | Status | Comment |
---|---|---|
WebXR Device API The definition of 'XRRigidTransform.orientation' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
orientation | Chrome Full support 79 | Edge Full support 79 | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android Full support 79 | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android Full support 11.2 |
Legend
- Full support
- Full support
- No support
- No support