Maestro C API  v0.1 Alpha
Maestro calibration functions

These functions are used to control the calibration of the Maestro glove. More...

Functions

bool start_wrist_calibration (intptr_t maestroPtr)
 
bool end_wrist_calibration (intptr_t maestroPtr)
 
bool start_proximal_calibration (intptr_t maestroPtr)
 
bool end_proximal_calibration (intptr_t maestroPtr)
 
bool start_thumb_calibration (intptr_t maestroPtr)
 
bool end_thumb_calibration (intptr_t maestroPtr)
 
const CalibrationState *const get_calibration_state (intptr_t maestroPtr)
 

Detailed Description

These functions are used to control the calibration of the Maestro glove.

#include "maestro.h"

The Maestro should be calibrated "top down" in the order of Wrist, Proximal joints, and Distal joints. Each section can be recalibrated independently, but any sections "below" must also be recalibrated. For example, if you recalibrate the proximal joints, the wrist calibration will remain valid, but the thumb will need to be recalibrated. If you recalibrate the wrist, both proximal and thumb will need to be recalibrated.

Function Documentation

◆ end_proximal_calibration()

bool end_proximal_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not proximal calibration was stopped. If the proximal joints were not calibrating or maestroPtr is invalid, false is returned.

◆ end_thumb_calibration()

bool end_thumb_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not thumb calibration was stopped. If the thumb was not calibrating or maestroPtr is invalid, false is returned.

◆ end_wrist_calibration()

bool end_wrist_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not wrist calibration was stopped. If wrist was not calibrating or maestroPtr is invalid, false is returned.

◆ get_calibration_state()

const CalibrationState* const get_calibration_state ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
A structure containing the current states for each calibration step.

◆ start_proximal_calibration()

bool start_proximal_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not proximal calibration was started. If the proximal joints are already calibrating or maestroPtr is invalid, false is returned.

◆ start_thumb_calibration()

bool start_thumb_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not thumb calibration was started. If the thumb was already calibrating or maestroPtr is invalid, false is returned.

◆ start_wrist_calibration()

bool start_wrist_calibration ( intptr_t  maestroPtr)
Parameters
maestroPtrThe pointer the Maestro Glove context. Obtained by get_left_glove_pointer() or get_right_glove_pointer().
Returns
Whether or not wrist calibration was started. If wrist is already calibrating or maestroPtr is invalid, false is returned.