HandPose

class · sealed immutable thread-safe

namespace AR51.Net;

public sealed class HandPose

The joint positions of one hand, from a headset with hand tracking.

Positions are in meters, in the same AR 51 world as the body (left-handed, X right, Y up, Z forward). Instances are immutable and safe to share across threads.

Units

Positions are in meters, in the AR 51 world: left-handed, X right, Y up, Z forward (the same axes as Unity). See Data conventions.

How-to

This page is reference (facts only). For a walkthrough with a complete sample, see the Skeletons guide.

Properties

Property	Type	Access	Description
Positions	IReadOnlyList<Vector3>	get	Joint positions in meters, indexed by HandJoint.

Method summary

Method	Returns
GetPosition	Vector3

→ Full descriptions in Method details below.

Method details

GetPosition

method

public Vector3 GetPosition(HandJoint joint);

Gets the position of a hand joint, in meters.

Parameters

jointHandJointThe joint.

ReturnsVector3The position, or (0, 0, 0) when the headset did not report this joint.

Related types

Small types used by this class, documented here.

HandJoint

enum

public enum HandJoint

Hand joints reported in a HandPose. The value is the index into HandPose.Positions.

note

Joints run from the wrist to each fingertip. The thumb and little finger include the metacarpal joint near the wrist, so a hand has 23 joints.

Value	Meaning
Wrist = 0	Wrist.
ThumbTrapezium = 1	Thumb, trapezium joint at the base of the thumb.
ThumbMetacarpal = 2	Thumb, metacarpal joint.
ThumbProximal = 3	Thumb, proximal joint.
ThumbDistal = 4	Thumb, distal joint.
ThumbTip = 5	Thumb tip.
IndexProximal = 6	Index finger, proximal joint (knuckle).
IndexIntermediate = 7	Index finger, intermediate joint.
IndexDistal = 8	Index finger, distal joint.
IndexTip = 9	Index fingertip.
MiddleProximal = 10	Middle finger, proximal joint (knuckle).
MiddleIntermediate = 11	Middle finger, intermediate joint.
MiddleDistal = 12	Middle finger, distal joint.
MiddleTip = 13	Middle fingertip.
RingProximal = 14	Ring finger, proximal joint (knuckle).
RingIntermediate = 15	Ring finger, intermediate joint.
RingDistal = 16	Ring finger, distal joint.
RingTip = 17	Ring fingertip.
LittleMetacarpal = 18	Little finger, metacarpal joint.
LittleProximal = 19	Little finger, proximal joint (knuckle).
LittleIntermediate = 20	Little finger, intermediate joint.
LittleDistal = 21	Little finger, distal joint.
LittleTip = 22	Little fingertip.

See also

• Skeletons guide — walkthrough with a complete, compiled sample
• Class index — every AR51.Net type
• Data conventions, threading and errors