Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The transform
read-only attribute of the XRPose
interface is a XRRigidTransform
object providing the position and orientation of the pose relative to the base XRSpace
as specified when the pose was obtained by calling XRFrame.getPose()
.
Syntax
let poseTransform = xrPose.transform;
Value
An XRRigidTransform
which provides the position and orientation of the XRPose
relative to the XRFrame
to which this XRPose
is aligned. This is the same pose that's returned by the frame's getPose()
method.
Example
This handler for the XRSession
event select
handles events for tracked pointers. It determines the targeted object by passing the event frame's pose into a function called findTargetUsingRay()
, then dispatches the event differently depending on the user's handedness; this is done by comparing the value of the XRInputSource
property handedness
to a value in the variable user.handedness
. If the source is a controller in the user's primary hand, a function is called on the targeted object called primaryAction()
; otherwise, it calls the targeted object's offHandAction()
function.
xrSession.addEventListener("select", event => { let source = event.inputSource; let frame = event.frame; let targetRayPose = frame.getPose(source.targetRaySpace, myRefSpace); let targetObject = findTargetUsingRay(targetRay.transform.matrix); if (source.targetRayMode == "tracked-pointer") { if (source.handedness == user.handedness) { targetObject.primaryAction(); } else { targetObject.offHandAction(); } } });
Specifications
Specification | Status | Comment |
---|---|---|
WebXR Device API The definition of 'XRPose.transform' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
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