class MFnHikEffector

Jump to documentation

Inheritance:

MFnHikEffector < MFnTransform < MFnDagNode < MFnDependencyNode < MFnBase

public members:

	MFnHikEffector ( const MObject & object, MStatus * ReturnStatus = NULL )
MObject	create ( MObject parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
MVector	getPivotOffset ( MStatus * ReturnStatus = NULL ) const
MStatus	setPivotOffset ( const MVector & vector )
MColor	getEffColor ( MStatus * ReturnStatus = NULL ) const
MStatus	setEffColor ( const MColor & color )
MStatus	getAuxiliaryEffectors ( MObjectArray & effs ) const

Inherited from MFnTransform:

public members:

MObject	create ( MObject parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
MTransformationMatrix	transformation ( MStatus * ReturnStatus = NULL ) const
MStatus	set ( const MTransformationMatrix & transform )
MStatus	getScale ( double scale[3] ) const
MStatus	setScale ( const double scale[3] )
MStatus	scaleBy ( const double scale[3] )
MStatus	getShear ( double scale[3] ) const
MStatus	setShear ( const double shear[3] )
MStatus	shearBy ( const double shear[3] )
MStatus	getRotation ( MQuaternion &quaternion, MSpace::Space = MSpace::kTransform ) const
MStatus	setRotation ( const MQuaternion &quaternion, MSpace::Space = MSpace::kTransform )
MStatus	rotateBy ( const MQuaternion &quaternion, MSpace::Space = MSpace::kTransform )
MStatus	getRotation ( MEulerRotation &rotation ) const
MStatus	setRotation ( const MEulerRotation &rotation )
MStatus	rotateBy ( const MEulerRotation &rotation, MSpace::Space = MSpace::kTransform )
MStatus	getRotationQuaternion ( double &x, double &y, double &z, double &w, MSpace::Space = MSpace::kTransform ) const
MStatus	setRotationQuaternion ( double x, double y, double z, double w, MSpace::Space = MSpace::kTransform )
MStatus	rotateByQuaternion ( double x, double y, double z, double w, MSpace::Space = MSpace::kTransform )
MStatus	getRotation ( double rotation[3], MTransformationMatrix::RotationOrder & order ) const
MStatus	setRotation ( const double rotation[3], MTransformationMatrix::RotationOrder order )
MStatus	rotateBy ( const double rotation[3], MTransformationMatrix::RotationOrder order, MSpace::Space = MSpace::kTransform )
MVector	getTranslation ( MSpace::Space space, MStatus * ReturnStatus = NULL ) const
MStatus	setTranslation ( const MVector & vec, MSpace::Space space )
MStatus	translateBy ( const MVector & vec, MSpace::Space space )
MPoint	scalePivot ( MSpace::Space space, MStatus * ReturnStatus = NULL ) const
MStatus	setScalePivot ( const MPoint & point, MSpace::Space space, bool balance )
MVector	scalePivotTranslation ( MSpace::Space space , MStatus * ReturnStatus = NULL ) const
MStatus	setScalePivotTranslation ( const MVector & vec, MSpace::Space space )
MPoint	rotatePivot ( MSpace::Space space , MStatus * ReturnStatus = NULL ) const
MStatus	setRotatePivot ( const MPoint & point, MSpace::Space space, bool balance )
MVector	rotatePivotTranslation ( MSpace::Space space, MStatus * ReturnStatus = NULL ) const
MStatus	setRotatePivotTranslation ( const MVector & vec, MSpace::Space space )
MQuaternion	rotateOrientation ( MSpace::Space space , MStatus * ReturnStatus = NULL ) const
MStatus	setRotateOrientation ( const MQuaternion & quat, MSpace::Space space, bool balance )
MTransformationMatrix::RotationOrder	rotationOrder ( MStatus * ReturnStatus = NULL ) const
MStatus	setRotationOrder ( MTransformationMatrix::RotationOrder order, bool reorder )
MTransformationMatrix	restPosition ( MStatus * ReturnStatus) const
MStatus	setRestPosition ( const MTransformationMatrix & matrix )
MStatus	resetFromRestPosition ()
MStatus	clearRestPosition ()
MStatus	getRotation ( double rotation[3], MTransformationMatrix::RotationOrder & order, MSpace::Space ) const
MStatus	setRotation (const double rotation[3], MTransformationMatrix::RotationOrder order, MSpace::Space )
MVector	translation ( MSpace::Space space, MStatus * ReturnStatus = NULL ) const
enum	LimitType kScaleMinX kScaleMaxX kScaleMinY kScaleMaxY kScaleMinZ kScaleMaxZ kShearMinXY kShearMaxXY kShearMinXZ kShearMaxXZ kShearMinYZ kShearMaxYZ kRotateMinX kRotateMaxX kRotateMinY kRotateMaxY kRotateMinZ kRotateMaxZ kTranslateMinX kTranslateMaxX kTranslateMinY kTranslateMaxY kTranslateMinZ kTranslateMaxZ
bool	isLimited ( MFnTransform::LimitType type , MStatus * ReturnStatus = NULL ) const
double	limitValue ( MFnTransform::LimitType type , MStatus * ReturnStatus = NULL ) const
MStatus	setLimit ( MFnTransform::LimitType type , double value)
MStatus	enableLimit ( MFnTransform::LimitType type , bool flag)

Inherited from MFnDagNode:

public members:

	kNextPos
MObject	create ( const MTypeId &typeId, MObject & parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
MObject	create ( const MTypeId &typeId, const MString &name, MObject & parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
MObject	create ( const MString &type, MObject & parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
MObject	create ( const MString &type, const MString &name, MObject & parent = MObject::kNullObj , MStatus * ReturnStatus = NULL )
unsigned int	parentCount ( MStatus * ReturnStatus = NULL ) const
MObject	parent ( unsigned int i, MStatus * ReturnStatus = NULL ) const
MStatus	addChild ( MObject & child , unsigned int index = kNextPos , bool keepExistingParents = false )
MStatus	removeChild ( MObject & child )
MStatus	removeChildAt ( unsigned int index )
unsigned int	childCount ( MStatus * ReturnStatus = NULL ) const
MObject	child ( unsigned int i, MStatus * ReturnStatus = NULL ) const
MObject	dagRoot ( MStatus * ReturnStatus = NULL )
bool	hasParent ( const MObject & node, MStatus * ReturnStatus = NULL ) const
bool	hasChild (const MObject & node, MStatus * ReturnStatus = NULL ) const
bool	isChildOf (const MObject & node, MStatus * ReturnStatus = NULL ) const
bool	isParentOf (const MObject & node, MStatus * ReturnStatus = NULL ) const
bool	inUnderWorld ( MStatus * ReturnStatus = NULL ) const
bool	inModel ( MStatus * ReturnStatus = NULL ) const
bool	isInstanceable ( MStatus * ReturnStatus=NULL ) const
MStatus	setInstanceable ( const bool how )
bool	isInstanced ( bool indirect = true, MStatus * ReturnStatus = NULL ) const
bool	isInstancedAttribute ( const MObject & attr, MStatus * ReturnStatus = NULL ) const
unsigned int	instanceCount ( bool total, MStatus * ReturnStatus = NULL ) const
MObject	duplicate ( bool instance = false, bool instanceLeaf = false, MStatus * ReturnStatus = NULL ) const
MStatus	getPath ( MDagPath & path )
MStatus	getAllPaths ( MDagPathArray & paths )
MString	fullPathName ( MStatus *ReturnStatus = NULL)
MString	partialPathName ( MStatus *ReturnStatus = NULL)
MMatrix	transformationMatrix ( MStatus * ReturnStatus = NULL ) const
bool	isIntermediateObject ( MStatus * ReturnStatus = NULL ) const
MStatus	setIntermediateObject ( bool isIntermediate )
int	objectColor ( MStatus * ReturnStatus = NULL ) const
MStatus	setObjectColor ( int color )
bool	usingObjectColor ( MStatus * ReturnStatus = NULL ) const
MStatus	setUseObjectColor ( bool useObjectColor )
MBoundingBox	boundingBox ( MStatus * ReturnStatus = NULL ) const
MDagPath	dagPath ( MStatus * ReturnStatus = NULL ) const
virtual MStatus	setObject ( const MDagPath & path )
virtual MStatus	setObject ( MObject & object )
MObject	model ( MStatus * ReturnStatus = NULL ) const
virtual MStatus	setObject ( const MObject & object )

Inherited from MFnDependencyNode:

public members:

virtual MFn::Type	type () const
enum	MAttrClass kGlobalDynamicAttr kLocalDynamicAttr
MObject	create ( const MTypeId & typeId , MStatus * ReturnStatus = NULL )
MObject	create ( const MTypeId & typeId , const MString & name , MStatus * ReturnStatus = NULL )
MObject	create ( const MString & type , MStatus * ReturnStatus = NULL )
MObject	create ( const MString & type , const MString & name , MStatus * ReturnStatus = NULL )
MTypeId	typeId ( MStatus * ReturnStatus = NULL ) const
MString	typeName ( MStatus * ReturnStatus = NULL ) const
MString	name ( MStatus * ReturnStatus = NULL ) const
MString	setName ( const MString & name , MStatus * ReturnStatus = NULL )
MStatus	getConnections ( MPlugArray & array ) const
unsigned int	attributeCount ( MStatus * ReturnStatus=NULL) const
MObject	attribute ( unsigned int index, MStatus * ReturnStatus=NULL) const
MObject	reorderedAttribute ( unsigned int index, MStatus * ReturnStatus=NULL) const
MObject	attribute ( const MString & attrName, MStatus * ReturnStatus=NULL) const
MAttrClass	attributeClass ( const MObject & attr, MStatus * ReturnStatus=NULL) const
MStatus	getAffectedAttributes ( const MObject & attr, MObjectArray & affectedAttributes ) const
MStatus	getAffectedByAttributes ( const MObject & attr, MObjectArray & affectedByAttributes ) const
MPlug	findPlug ( const MObject & attr, bool wantNetworkedPlug, MStatus * ReturnStatus=NULL) const
MPlug	findPlug ( const MString & attrName, bool wantNetworkedPlug, MStatus * ReturnStatus=NULL) const
MPlug	findPlug ( const MObject & attr, MStatus * ReturnStatus=NULL) const
MPlug	findPlug ( const MString & attrName, MStatus * ReturnStatus=NULL) const
MStatus	addAttribute ( const MObject & attr, MAttrClass type = kLocalDynamicAttr )
MStatus	removeAttribute ( const MObject & attr, MAttrClass type = kLocalDynamicAttr )
MPxNode *	userNode ( MStatus * ReturnStatus=NULL ) const
bool	isFromReferencedFile ( MStatus * ReturnStatus=NULL) const
bool	isShared ( MStatus * ReturnStatus=NULL) const
bool	hasUniqueName ( MStatus * ReturnStatus=NULL) const
MString	parentNamespace ( MStatus * ReturnStatus=NULL) const
bool	isLocked ( MStatus * ReturnStatus=NULL) const
MStatus	setLocked ( bool locked )
static MString	classification ( const MString & nodeTypeName )
bool	isNewAttribute ( const MObject & attr, MStatus * ReturnStatus=NULL) const
static unsigned int	allocateFlag ( const MString pluginName, MStatus * ReturnStatus=NULL )
static MStatus	deallocateFlag (const MString pluginName, unsigned int flag)
static MStatus	deallocateAllFlags (const MString pluginName)
MStatus	setFlag (unsigned int flag, bool state)
bool	isFlagSet (unsigned int flag, MStatus * ReturnStatus=NULL) const
bool	isDefaultNode ( MStatus * ReturnStatus=NULL) const
MStatus	setDoNotWrite ( bool flag )
bool	canBeWritten ( MStatus * ReturnStatus=NULL) const
bool	hasAttribute (const MString & name , MStatus * ReturnStatus=NULL) const
MObject	getAliasAttr (bool force, MStatus * ReturnStatus=NULL)
bool	setAlias (const MString & alias,const MString & name , const MPlug & plug, bool add=true, MStatus * ReturnStatus=NULL)
bool	findAlias (const MString & alias, MObject & attrObj, MStatus * ReturnStatus=NULL) const
bool	getAliasList ( MStringArray & strArray, MStatus * ReturnStatus=NULL)
MString	plugsAlias (const MPlug & plug, MStatus * ReturnStatus=NULL)
	public
bool	getPlugsAlias (const MPlug & plug, MString & aliasName, MStatus * ReturnStatus=NULL)

Inherited from MFnBase:

public members:

virtual MFn::Type	type () const
bool	hasObj ( MFn::Type ) const
bool	hasObj ( const MObject & ) const
MObject	object ( MStatus * ReturnStatus = NULL ) const
virtual MStatus	setObject ( MObject & object )
virtual MStatus	setObject ( const MObject & object )

Documentation

Description

MFnHikEffector is the function set for full body ik effectors. An Full Body IK (FBIK/HIK) effector is a special transform that allows users to manipulate a Full Body IK system.

The methods of the parent class MFnTransform used to position the end effector.

Functions

MFnHikEffector:: MFnHikEffector ()

Description

Default class constructor. The function set is not attached to an MObject.

MFnHikEffector:: MFnHikEffector ( MObject & object, MStatus * ReturnStatus )

Description

Class constructor that initializes the function set to the given MObject.

Arguments

• object the MObject to attach the function set to
• ReturnStatus the return status
  • MS::kSuccess if the function set is successfully attached
  • MS::kInvalidParameter if the MObject does not represent a valid Maya object or if the function set is not allowed to attach to this MObject

MFnHikEffector:: MFnHikEffector ( const MObject & object, MStatus * ReturnStatus )

Description

Class constructor that initializes the function set to the given constant MObject.

Arguments

• object the const MObject to attach the function set to
• ReturnStatus the return status
  • MS::kSuccess if the function set is successfully attached
  • MS::kInvalidParameter if the MObject does not represent a valid Maya object or if the function set is not allowed to attach to this MObject

MFnHikEffector:: MFnHikEffector ( const MDagPath & object, MStatus * ReturnStatus )

Description

Class constructor that initializes the function set to the given constant MDagPath object.

Arguments

• object the const MDagPath to attach the function set to
• ReturnStatus the return status
  • MS::kSuccess if the function set is successfully attached
  • MS::kInvalidParameter if the MObject does not represent a valid Maya object or if the function set is not allowed to attach to this MObject

MFn::Type MFnHikEffector:: type () const

Description

Return the type of this function set.

Return Value

• the constant MFn::kHikEffector

MFnHikEffector:: ~MFnHikEffector ()

Description

Class destructor.

MObject MFnHikEffector:: create ( MObject parent, MStatus * ReturnStatus )

Description

Creates a new fbik effector.

Arguments

• parent parent DAG node (usually none)
• ReturnStatus return status

Return Value

• a handle to the new object

Status Codes

• MS::kSuccess operation successful
• MS::kLicenseFailure application not licensed for attempted operation
• MS::kFailure unexpected failure

MVector MFnHikEffector:: getPivotOffset ( MStatus * ReturnStatus) const

Description

Retrieve the pivot offset of this effector.

Arguments

• ReturnStatus return status

Return Value

Pivot offset vector.

Status Codes

• MS::kSuccess operation successful
• MS::kFailure object error

MStatus MFnHikEffector:: setPivotOffset (const MVector & vector)

Description

Set the pivot offset for this effector.

Arguments

• vector the new pivot offset

Return Value

Status code

Status Codes

• MS::kSuccess operation successful
• MS::kFailure object error

MColor MFnHikEffector:: getEffColor ( MStatus * ReturnStatus) const

Description

Retrieve the cached humanIK color of this effector.

Arguments

• ReturnStatus return status

Return Value

Pivot offset vector.

Status Codes

• MS::kSuccess operation successful
• MS::kFailure object error

MStatus MFnHikEffector:: setEffColor (const MColor & color)

Description

Set the humanIK color for this effector.

Arguments

• color the new color

Return Value

Status code

Status Codes

• MS::kSuccess operation successful
• MS::kFailure object error

MStatus MFnHikEffector:: getAuxiliaryEffectors ( MObjectArray & effs) const

Description

Returns an array of the auxiliary effectors associated with this effector. Auxiliary effectors are used by humanIK to act as additional pivots.

Arguments

• effs the auxiliary effectors for this effector

Return Value

Status code

Status Codes

• MS::kSuccess operation successful
• MS::kFailure object error

This class has no child classes.