C++ API Reference
MIkHandleGroup Class Reference

IK handle groups. More...

#include <MIkHandleGroup.h>

Public Member Functions

 MIkHandleGroup ()
 Default constructor. More...
 
 ~MIkHandleGroup ()
 The class destructor.
 
int priority (MStatus *ReturnStatus=NULL) const
 Return the priority value of this handle group. More...
 
int solverID (MStatus *ReturnStatus=NULL) const
 Return the solver id used by this handle group. More...
 
int solverPriority (MStatus *ReturnStatus=NULL) const
 return the priority of the solver used by this handle group. More...
 
MStatus setPriority (int)
 Set the priority of this handle group. More...
 
MStatus setSolverID (int)
 Set the solver id for this handle group. More...
 
bool checkEffectorAtGoal (MStatus *ReturnStatus=NULL)
 Determines whether the end-effector at the handle(goal) location. More...
 
MStatus solve ()
 Do all ik solving steps for this group. More...
 
int dofCount (MStatus *ReturnStatus=NULL) const
 Return the total number of degrees of freedom of this handle group. More...
 
int handleCount (MStatus *ReturnStatus=NULL) const
 Return the number of handles in the handle list for this group. More...
 
MObject handle (int ith, MStatus *ReturnStatus=NULL)
 Return the ith handle in the handle list for this group. More...
 

Static Public Member Functions

static const char * className ()
 Returns the name of this class. More...
 

Friends

class MPxIkSolver
 
class MPxIkSolverNode
 

Detailed Description

IK handle groups.

Group class for ik handles. Each group has an associated solver and priority. A single chain solver handle group has only one handle in its group.

Examples:
ik2Bsolver/ik2Bsolver.cpp, and simpleSolverNode/simpleSolverNode.cpp.

Constructor & Destructor Documentation

OPENMAYA_MAJOR_NAMESPACE_OPEN MIkHandleGroup ( )

Default constructor.

The instance is set to contain no groups.

Member Function Documentation

int priority ( MStatus ReturnStatus = NULL) const

Return the priority value of this handle group.

Parameters
[out]ReturnStatusStatus code
Returns
The priority
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
int solverID ( MStatus ReturnStatus = NULL) const

Return the solver id used by this handle group.

Parameters
[out]ReturnStatusStatus code
Returns
The solver id for this group
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
int solverPriority ( MStatus ReturnStatus = NULL) const

return the priority of the solver used by this handle group.

Parameters
[out]ReturnStatusStatus code
Returns
The solver priority
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
MStatus setPriority ( int  priority)

Set the priority of this handle group.

Parameters
[in]prioritythe priority value to set
Returns
Status code
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
MStatus setSolverID ( int  id)

Set the solver id for this handle group.

Parameters
[in]idthe id value to set
Returns
Status code
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
bool checkEffectorAtGoal ( MStatus ReturnStatus = NULL)

Determines whether the end-effector at the handle(goal) location.

Parameters
[out]ReturnStatusStatus code
Returns
  • true The end-effector is at the goal location
  • false The end-effector is not at the goal location
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
MStatus solve ( )

Do all ik solving steps for this group.

Returns
Status code
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
int dofCount ( MStatus ReturnStatus = NULL) const

Return the total number of degrees of freedom of this handle group.

Parameters
[out]ReturnStatusStatus code
Returns
The total number of dofs
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
int handleCount ( MStatus ReturnStatus = NULL) const

Return the number of handles in the handle list for this group.

Parameters
[out]ReturnStatusStatus code
Returns
The number of handles
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
MObject handle ( int  ith,
MStatus ReturnStatus = NULL 
)

Return the ith handle in the handle list for this group.

Parameters
[in]iththe index of the handle
[out]ReturnStatusStatus code
Returns
An MObject for the handle
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occurred
  • MS::kInvalidParameter An invalid array index was passed
Examples:
ik2Bsolver/ik2Bsolver.cpp, and simpleSolverNode/simpleSolverNode.cpp.
const char * className ( )
static

Returns the name of this class.

Returns
The name of this class.

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