Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The read-only XRReferenceSpaceEvent
property transform
indicates the position and orientation of the affected referenceSpace
's native origin after the changes the event represents are applied. The transform
is defined using the old coordinate system, which allows it to be used to convert coordinates from the pre-event coordinate system to the post-event coordiante system.
Syntax
let refSpace = xrReferenceSpaceEvent.transform;
Value
An XRRigidTransform
object providing a transform that can be used to convert coordinates from the pre-event coordinate system to the post-event coordinate system.
Usage notes
Upon receiving a reset
event, you can apply the transform
to cached position or orientation information to shift them into the updated coordinate system. Alternatively, you can just discard any cached positional information and recompute from scratch. The approach you take will depend on your needs.
For details on what causes a reset
event and how to respond, see the reset
event's documentation.
Examples
This example handles the reset
event by walking through all the objects in a scene, updating each object's position by multiplying it with the event's given transform
. The scene is represented by a scene
object, with all the objects in an array called objects
within it.
xrReferenceSpace.addEventListener("reset", event => {
for (let obj of scene.objects) {
mat4.multiply(obj.transform, obj.transform, event.transform);
}
});
Specifications
Specification | Status | Comment |
WebXR Device APIThe definition of 'XRReferenceSpaceEvent.transform' in that specification. | Working Draft | Initial definition. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
transform
|
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
XRReferenceSpaceEvent.transform by Mozilla Contributors is licensed under CC-BY-SA 2.5.