Back to Content

XRJointPose: radius property

files/en-us/web/api/xrjointpose/radius/index.md

latest1.1 KB
Original Source

{{APIRef("WebXR Device API")}}

The read-only radius property of the {{domxref("XRJointPose")}} interface indicates the radius (distance from skin) for a joint.

Value

A number indicating the radius in meters.

Examples

Getting the radius for a hand joint

Call {{domxref("XRFrame.getJointPose()")}} with an {{domxref("XRJointSpace")}} and an {{domxref("XRReferenceSpace")}} to get an XRJointPose object which provides the radius property.

js
navigator.xr
  .requestSession({ optionalFeatures: ["hand-tracking"] })
  .then(/** … */);

function renderFrame(session, frame) {
  // …

  for (const inputSource of session.inputSources) {
    if (inputSource.hand) {
      const indexFingerTipJoint = inputSource.hand.get("index-finger-tip");
      const radius = frame.getJointPose(
        indexFingerTipJoint,
        referenceSpace,
      ).radius;
    }
  }
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("XRHand")}}
  • {{domxref("XRReferenceSpace")}}
  • {{domxref("XRJointSpace")}}
  • {{domxref("XRFrame.getJointPose()")}}