C++ API Reference
MDeviceState Class Reference

Input device state. More...

#include <MDeviceState.h>

Public Member Functions

virtual ~MDeviceState ()
 Class destructor.
 
int devicePosition (const unsigned short int axis) const
 Returns the position of the device for the specified axis. More...
 
int devicePosition (const MString &axisName) const
 Returns the position of the device for the specified axis. More...
 
void setDevicePosition (const int position, const unsigned short int axis)
 Sets the position of the device for the specified axis. More...
 
void setDevicePosition (const int position, const MString &axisName)
 Sets the position of the device for the specified axis. More...
 
bool buttonState (const unsigned short int button) const
 Returns the state of the given button. More...
 
bool buttonState (const MString &buttonName) const
 Returns the state of the named button. More...
 
void setButtonState (const bool state, const unsigned short int button)
 Set the state of the specified button. More...
 
void setButtonState (const bool state, const MString &buttonName)
 Set the state of the specified button. More...
 
int maxAxis () const
 Return the value of the axis with the largest value. More...
 
bool isNull ()
 Returns true if this device state is NULL;. More...
 

Detailed Description

Input device state.

MDeviceState is a generic event class for input devices. Input device classes (such as MPxMidiInputDevice) are responsible for converting specific event types to an MDeviceState which Maya understands.

Member Function Documentation

int devicePosition ( const unsigned short int  axis) const

Returns the position of the device for the specified axis.

Parameters
[in]axisThe device axis to be tested
Returns
The position of the device for the specified axis
int devicePosition ( const MString axisName) const

Returns the position of the device for the specified axis.

Parameters
[in]axisNameThe name of the device axis to be tested
Returns
The position of the device for the specified axis
void setDevicePosition ( const int  position,
const unsigned short int  axis 
)

Sets the position of the device for the specified axis.

Parameters
[in]positionThe new position value
[in]axisThe axis of the device to be set
void setDevicePosition ( const int  position,
const MString axis 
)

Sets the position of the device for the specified axis.

Parameters
[in]positionThe new position value
[in]axisThe name of the axis of the device to be set
bool buttonState ( const unsigned short int  button) const

Returns the state of the given button.

Parameters
[in]buttonThe number of the button to be tested
Returns
  • true button pressed
  • false button released
bool buttonState ( const MString buttonName) const

Returns the state of the named button.

Parameters
[in]buttonNameThe name of the button to be tested
Returns
  • true button pressed
  • false button released
void setButtonState ( const bool  state,
const unsigned short int  button 
)

Set the state of the specified button.

Parameters
[in]stateThe state to be set (true or false)
[in]buttonThe button number
void setButtonState ( const bool  state,
const MString buttonName 
)

Set the state of the specified button.

Parameters
[in]stateThe state to be set (true or false)
[in]buttonNameThe name of the button to be set
int maxAxis ( ) const

Return the value of the axis with the largest value.

This is used to dejitter absolute devices.

Returns
The value of the largest axis
bool isNull ( )

Returns true if this device state is NULL;.

Returns
  • true The device state is NULL
  • false The device state is not NULL

The documentation for this class was generated from the following files: