HandPose.TryGetJoints Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the pose of multiple hand joints, expressed in the specified coordinate system.
bool TryGetJoints(SpatialCoordinateSystem const& coordinateSystem, winrt::array_view <HandJointKind> const& joints, winrt::array_view <JointPose> & jointPoses);public bool TryGetJoints(SpatialCoordinateSystem coordinateSystem, HandJointKind[] joints, JointPose[] jointPoses);function tryGetJoints(coordinateSystem, joints, jointPoses)Public Function TryGetJoints (coordinateSystem As SpatialCoordinateSystem, joints As HandJointKind(), jointPoses As JointPose()) As BooleanParameters
- coordinateSystem
- SpatialCoordinateSystem
The coordinate system in which to express the joint poses.
- joints
- HandJointKind[]
The array of hand joint kinds to locate.
- jointPoses
- JointPose[]
The array of poses to fill, one for each matching element in the joints array.
Returns
bool
True if the hand can be located within the specified coordinate system; otherwise, false.
Remarks
The jointPoses array to be filled must match the length of the joints array.
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.
This method will return false if the specified coordinate system cannot be located at the moment.