Maestro C API  v0.1 Alpha
Rotation access functions

These functions are used to get the rotations for specific hand and finger joints. More...

Functions

float get_index_proximal_rotation_ratio (intptr_t maestroPtr)
 
float get_middle_proximal_rotation_ratio (intptr_t maestroPtr)
 
float get_ring_proximal_rotation_ratio (intptr_t maestroPtr)
 
float get_little_proximal_rotation_ratio (intptr_t maestroPtr)
 
float get_thumb_proximal_rotation_ratio (intptr_t maestroPtr)
 
float get_index_proximal_rotation (intptr_t maestroPtr)
 
float get_middle_proximal_rotation (intptr_t maestroPtr)
 
float get_ring_proximal_rotation (intptr_t maestroPtr)
 
float get_little_proximal_rotation (intptr_t maestroPtr)
 
float get_thumb_abduction_rotation (intptr_t maestroPtr)
 
float get_thumb_proximal_rotation (intptr_t maestroPtr)
 
float get_wrist_proximal_rotation (intptr_t maestroPtr)
 
void get_rotation_context (intptr_t maestroPtr, RotationContext *pRotationContext)
 

Detailed Description

These functions are used to get the rotations for specific hand and finger joints.

#include "maestro.h"

Function Documentation

◆ get_index_proximal_rotation()

float get_index_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the index finger proximal joint in degrees.

◆ get_index_proximal_rotation_ratio()

float get_index_proximal_rotation_ratio ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Returns a floating-point number in the inclusive range (0, 1) representing the current displacement in proportion to the displacement range. If the index finger proximal joint is at the maximum displacement (rotated all the way down), 1 is returned. If at the minimum displacement (all the way up, such as when the hand is held flat), 0 is returned. If between the minimum and maximum, the proportion is returned. For example, half way through the displacement range (halfway between the minimum and maximum rotations/displacements), 0.5 is returned.

◆ get_little_proximal_rotation()

float get_little_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the little (pinky) finger proximal joint in degrees.

◆ get_little_proximal_rotation_ratio()

float get_little_proximal_rotation_ratio ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Returns a floating-point number in the inclusive range (0, 1) representing the current displacement in proportion to the displacement range. If the little (pinky) finger proximal joint is at the maximum displacement (rotated all the way down), 1 is returned. If at the minimum displacement (all the way up, such as when the hand is held flat), 0 is returned. If between the minimum and maximum, the proportion is returned. For example, half way through the displacement range (halfway between the minimum and maximum rotations/displacements), 0.5 is returned.

◆ get_middle_proximal_rotation()

float get_middle_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the middle finger proximal joint in degrees.

◆ get_middle_proximal_rotation_ratio()

float get_middle_proximal_rotation_ratio ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Returns a floating-point number in the inclusive range (0, 1) representing the current displacement in proportion to the displacement range. If the middle finger proximal joint is at the maximum displacement (rotated all the way down), 1 is returned. If at the minimum displacement (all the way up, such as when the hand is held flat), 0 is returned. If between the minimum and maximum, the proportion is returned. For example, half way through the displacement range (halfway between the minimum and maximum rotations/displacements), 0.5 is returned.

◆ get_ring_proximal_rotation()

float get_ring_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the ring finger proximal joint in degrees.

◆ get_ring_proximal_rotation_ratio()

float get_ring_proximal_rotation_ratio ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Returns a floating-point number in the inclusive range (0, 1) representing the current displacement in proportion to the displacement range. If the ring finger proximal joint is at the maximum displacement (rotated all the way down), 1 is returned. If at the minimum displacement (all the way up, such as when the hand is held flat), 0 is returned. If between the minimum and maximum, the proportion is returned. For example, half way through the displacement range (halfway between the minimum and maximum rotations/displacements), 0.5 is returned.

◆ get_rotation_context()

void get_rotation_context ( intptr_t  maestroPtr,
RotationContext pRotationContext 
)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
pRotationContextA pointer to a RotationContext to be updated with the current rotation values. These are the same values obtained by calling the get_..._rotation() functions independently.

◆ get_thumb_abduction_rotation()

float get_thumb_abduction_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the thumb abduction joint in degrees.

◆ get_thumb_proximal_rotation()

float get_thumb_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the thumb proximal joint in degrees.

◆ get_thumb_proximal_rotation_ratio()

float get_thumb_proximal_rotation_ratio ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Returns a floating-point number in the inclusive range (0, 1) representing the current displacement in proportion to the displacement range. If the thumb proximal joint is at the maximum displacement (rotated all the way down), 1 is returned. If at the minimum displacement (all the way up, such as when the hand is held flat), 0 is returned. If between the minimum and maximum, the proportion is returned. For example, half way through the displacement range (halfway between the minimum and maximum rotations/displacements), 0.5 is returned.

◆ get_wrist_proximal_rotation()

float get_wrist_proximal_rotation ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
The rotation for the wrist proximal joint in degrees.