The XRRigidTransform
is a WebXR API interface that represents the 3D geometric transform described by a position and orientation.
XRRigidTransform
is used to specify transforms throughout the WebXR APIs, including:
- The offset and orientation relative to the parent reference space to use when creating a new reference space with
getOffsetReferenceSpace()
. - The
transform
of anXRView
. - The
transform
of anXRPose
. - The
XRReferenceSpaceEvent
event'stransform
property, as found in thereset
event received by anXRReferenceSpace
.
The advantage to using XRRigidTransform
in these places rather than bare arrays that providing the matrix data is that the XRRigidTransform
automatically does things like computing the inverse of the transform. Even better, once it's been computed, it's cached so that subsequent requests are significantly faster.
Constructor
new XRRigidTransform()
- Creates a new
XRRigidTransform
object which represents a transform that applies a specified position and/or orientation.
Properties
XRRigidTransform.position
Read only '- A
DOMPointReadOnly
specifying a 3-dimensional point, expressed in meters, describing the translation component of the transform. Thew
property is always1.0
. XRRigidTransform.orientation
Read only '- A
DOMPointReadOnly
which contains a unit quaternion describing the rotational component of the transform. As a unit quaternion, its length is always normalized to1.0
. XRRigidTransform.matrix
Read only '- Returns the transform matrix in the form of a 16-member
Float32Array
. See the section Matrix format for how the array is used to represent a matrix.
XRRigidTransform.inverse
Read only '- Returns a
XRRigidTransform
which is the inverse of this transform. That is, if applied to an object that had been previously transformed by the original transform, it will undo the transform and return the original object.
Usage notes
When an XRRigidTransform
is interpreted, the orientation is always applied to the affected object before the position is applied.
Example
This code snippet creates an XRRigidTransform
to specify the offset and orientation in relation to the current reference space to use when creating a new reference space. It then requests the first animation frame callback by calling the session's requestAnimationFrame()
method.
xrSession.requestReferenceSpace(refSpaceType)
.then((refSpace) => {
xrReferenceSpace = refSpace;
xrReferenceSpace = xrReferenceSpace.getOffsetReferenceSpace(
new XRRigidTransform(viewerStartPosition, cubeOrientation));
animationFrameRequestID = xrSession.requestAnimationFrame(drawFrame);
Specifications
Specification | Status | Comment |
---|---|---|
WebXR Device APIThe definition of 'XRRigidTransform' in that specification. | Working Draft | Initial definition. |
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
XRRigidTransform
|
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 |
XRRigidTransform() constructor
|
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 |
inverse
|
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 |
matrix
|
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 |
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 |
position
|
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
XRRigidTransform by Mozilla Contributors is licensed under CC-BY-SA 2.5.