Share via


HandPose.GetRelativeJoints Method

Definition

Gets the pose of multiple hand joints, each expressed relative to its matching reference joint.

void GetRelativeJoints(winrt::array_view <HandJointKind> const& joints, winrt::array_view <HandJointKind> const& referenceJoints, winrt::array_view <JointPose> & jointPoses);
public void GetRelativeJoints(HandJointKind[] joints, HandJointKind[] referenceJoints, JointPose[] jointPoses);
function getRelativeJoints(joints, referenceJoints, jointPoses)
Public Sub GetRelativeJoints (joints As HandJointKind(), referenceJoints As HandJointKind(), jointPoses As JointPose())

Parameters

joints
HandJointKind[]

The array of hand joint kinds to locate.

referenceJoints
HandJointKind[]

The array of reference hand joint kinds, relative to which each matching joint in the joints array will be located.

jointPoses
JointPose[]

The array of relative poses to fill, one for each matching element in the joints and referenceJoints arrays.

Remarks

The coordinate system is right-handed, with +y up, +x to the right, and -z forward.

All joints except for tip joints are interior to the hand. Finger joint poses represent the base of the named bone. Joints are oriented with forward (-z) pointing towards the tip of each finger, up (+y) pointing out of the back of the hand or finger, and right (+x) pointing perpendicular to forward and up.

Applies to