Unigine::Plugins::LeapMotion::Bone Struct

struct Bone
{
	int type;
	float length;
	float width;
	int is_valid;
	Unigine::Math::vec3 prev_joint;
	Unigine::Math::vec3 next_joint;
	Unigine::Math::vec3 center;
	Unigine::Math::vec3 direction;
	Unigine::Math::mat4 basis;
};

LeapMotionBone Class

Enums

TYPE#

Name	Description
Bone::TYPE_METACARPAL = 0	Metacarpal bone. A bone connected to the wrist inside the palm.
Bone::TYPE_PROXIMAL = 1	Proximal bone. A bone connecting to the palm.
Bone::TYPE_INTERMEDIATE = 2	Intermediate bone. A bone between the tip and the base.
Bone::TYPE_DISTAL = 3	Distal bone. A bone at the tip of the finger.
Bone::BONE_NUM_TYPES =	Total number of bone types.

Members

---

int getType ( ) #

Returns the type of the bone.

Return value

Bone type. One of the Bone::TYPE_* values.

float getLength ( ) #

Returns the length of the bone.

Return value

Length of the bone, in meters.

float getWidth ( ) #

Returns the width of the bone, in meters.

Return value

Width of the bone, in meters.

vec3 getPrevJoint ( ) #

Returns the coordinates of the end of the bone, closest to the wrist (proximal).

Return value

Coordinates of the end of the bone, closest to the wrist (proximal).

vec3 getNextJoint ( ) #

Returns the coordinates of the end of the bone, closest to the finger tip (distal).

Return value

Coordinates of the end of the bone, closest to the finger tip (distal).

vec3 getCenter ( ) #

Returns the coordinates of the center of the bone.

Return value

Coordinates of the center of the bone.

vec3 getDirection ( ) #

Returns the normalized direction of the bone from wrist to tip.

Return value

Normalized direction of the bone from wrist to tip.

mat4 getBasis ( ) #

Returns the orthonormal basis vectors for this Bone as a Matrix.

Basis vectors specify the orientation of a bone:

• X - Perpendicular to the longitudinal axis of the bone; exits the sides of the finger.
• Y (or up vector) - Perpendicular to the longitudinal axis of the bone; exits the top and bottom of the finger. Increases in the upward direction.
• Z - Aligned with the longitudinal axis of the bone. Increases toward the base of the finger.

The bases provided for the right hand use the right-hand rule; those for the left hand use the left-hand rule. Thus, the positive direction of the x-basis is to the right for the right hand and to the left for the left hand. You can change from right-hand to left-hand rule by multiplying the z basis vector by -1.

You can use the basis vectors for such purposes as measuring complex finger poses and skeletal animation.

Return value

Orthonormal basis vectors for the bone as a Matrix.

int isValid ( ) #

Returns a value indicating if the bone contains valid tracking data.

Return value

1 if the bone contains valid tracking data; otherwise, 0.