MFnDirectionManip Class Reference
[OpenMayaUI - API module for user interfaceFunctionSet classes]

#include <MFnDirectionManip.h>

Inheritance diagram for MFnDirectionManip:

Inheritance graph
[legend]
Collaboration diagram for MFnDirectionManip:

Collaboration graph
[legend]

List of all members.


Detailed Description

DirectionManip function set.

The DirectionManip allows the user to specify a direction, as defined by the vector from the start point to the manipulator position. It uses a FreePointTriadManip to specify the end point of a vector relative to a given start point. This manipulator generates a vector from the start point to the end point.

Examples:

swissArmyManip.cpp.


Public Member Functions

virtual MFn::Type type () const
 Function set type.
virtual ~MFnDirectionManip ()
 Destructor.
 MFnDirectionManip ()
 Default constructor.
 MFnDirectionManip (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
 MFnDirectionManip (const MDagPath &object, MStatus *ret=NULL)
 Constructor.
MObject create (MStatus *ReturnStatus=NULL)
MObject create (const MString &manipName, const MString &directionName, MStatus *ReturnStatus=NULL)
MStatus connectToDirectionPlug (MPlug &directionPlug)
MStatus setNormalizeDirection (bool state)
MStatus setDrawStart (bool state)
MStatus setStartPoint (MPoint &startPoint)
MStatus setDirection (MVector &direction)
unsigned int startPointIndex (MStatus *ReturnStatus=NULL) const
unsigned int endPointIndex (MStatus *ReturnStatus=NULL) const
unsigned int directionIndex (MStatus *ReturnStatus=NULL) const
 MFnDirectionManip (const MObject &object, MStatus *ret=NULL)
 Constructor.

Protected Member Functions

virtual const char * className () const
 Class name.

Constructor & Destructor Documentation

MFnDirectionManip::~MFnDirectionManip (  )  [virtual]

Destructor.

Class destructor.

MFnDirectionManip::MFnDirectionManip ( MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

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

Parameters:
[in] object The MObject to attach the function set to
[out] ReturnStatus the return status
Status Codes:

MFnDirectionManip::MFnDirectionManip ( const MDagPath object,
MStatus ReturnStatus = NULL 
)

Constructor.

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

Parameters:
[in] object The const MDagPath to attach the function set to
[out] ReturnStatus The return status
Status Codes:

MFnDirectionManip::MFnDirectionManip ( const MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

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

Parameters:
[in] object The MObject to attach the function set to
[out] ReturnStatus the return status
Status Codes:


Member Function Documentation

MFn::Type MFnDirectionManip::type (  )  const [virtual]

Function set type.

Return the class type : MFn::kDirectionManip

Reimplemented from MFnManip3D.

const char * MFnDirectionManip::className (  )  const [protected, virtual]

Class name.

Return the class name : "MFnDirectionManip"

Reimplemented from MFnManip3D.

MObject MFnDirectionManip::create ( MStatus ReturnStatus = NULL  ) 

Creates a new DirectionManip. This function set's object is set to be the new manipulator.

This method should only be used to create a non-composite DirectionManip.

The name that appears in the feedback line is "direction"

Parameters:
[out] ReturnStatus return status
Returns:
Newly created DirectionManip
Status Codes:

MObject MFnDirectionManip::create ( const MString manipName,
const MString directionName,
MStatus ReturnStatus = NULL 
)

Creates a new DirectionManip. This function set's object is set to be the new manipulator.

This method should only be used to create a non-composite DirectionManip.

The name that appears in the feedback line is specified by the directionName argument.

Parameters:
[in] directionName the name that appears in the feedback line
[out] ReturnStatus return status
Returns:
Newly created DirectionManip
Status Codes:

Reimplemented from MFnDependencyNode.

MStatus MFnDirectionManip::connectToDirectionPlug ( MPlug directionPlug  ) 

Connect to the direction plug. The data type corresponding to the directionPlug is MFnNumericData::k3Double.

Parameters:
[in] directionPlug the direction plug
Returns:
Examples:

MStatus MFnDirectionManip::setNormalizeDirection ( bool  state  ) 

Sets whether or not to the direction should be normalized. By default the direction is normalized.

Parameters:
[in] state whether or not the direction should be normalized
Returns:

MStatus MFnDirectionManip::setDrawStart ( bool  state  ) 

Sets whether or not to draw the start of the DirectionManip. The start of the DirectionManip is indicated by a grey dot. By default the start is not drawn.

Parameters:
[in] state whether or not the start should be drawn
Returns:

MStatus MFnDirectionManip::setStartPoint ( MPoint startPoint  ) 

Sets the start point of the DirectionManip.

Parameters:
[in] startPoint the start point of the DirectionManip
Returns:

MStatus MFnDirectionManip::setDirection ( MVector direction  ) 

Sets the direction of the DirectionManip.

Parameters:
[in] direction the direction of the DirectionManip
Returns:

unsigned int MFnDirectionManip::startPointIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the start point of the DirectionManip. The data type corresponding to this index is MFnNumericData::k3Double.

Parameters:
[out] ReturnStatus return status
Returns:
Start point index
Status Codes:
Examples:

unsigned int MFnDirectionManip::endPointIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the end point of the DirectionManip. The data type corresponding to this index is MFnNumericData::k3Double.

Parameters:
[out] ReturnStatus return status
Returns:
End point index
Status Codes:

unsigned int MFnDirectionManip::directionIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the direction. The data type corresponding to this index is MFnNumericData::k3Double.

Parameters:
[out] ReturnStatus return status
Returns:
Direction index
Status Codes:


Autodesk® Maya® 2009 © 1997-2008 Autodesk, Inc. All rights reserved. Generated with doxygen 1.5.6