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

#include <MFnDistanceManip.h>
Inheritance diagram for MFnDistanceManip:
Inheritance graph
[legend]
Collaboration diagram for MFnDistanceManip:
Collaboration graph
[legend]

List of all members.


Detailed Description

DistanceManip function set.

The DistanceManip allows the user to manipulate a point that is constrained to move along a line. This manipulator generates a single floating point value. Scaling factors can be used to determine how int the manipulator appears when it is drawn.

Examples:

footPrintManip.cpp, moveManip.cpp, and swissArmyManip.cpp.


Public Member Functions

virtual MFn::Type  type () const
  Function set type.
virtual  ~MFnDistanceManip ()
  Destructor.
  MFnDistanceManip ()
  Default constructor.
  MFnDistanceManip (MObject &object, MStatus *ReturnStatus=NULL)
  Constructor.
  MFnDistanceManip (const MDagPath &object, MStatus *ret=NULL)
  Constructor.
MObject  create (MStatus *ReturnStatus=NULL)
MObject  create (const MString &manipName, const MString &distanceName, MStatus *ReturnStatus=NULL)
MStatus  connectToDistancePlug (MPlug &distancePlug)
MStatus  setStartPoint (const MPoint &point)
MStatus  setDirection (const MVector &vector)
MStatus  setDrawStart (bool state)
MStatus  setDrawLine (bool state)
MStatus  setScalingFactor (double scalingFactor)
bool  isDrawStartOn (MStatus *ReturnStatus=NULL) const
bool  isDrawLineOn (MStatus *ReturnStatus=NULL) const
double  scalingFactor (MStatus *ReturnStatus=NULL) const
unsigned int  distanceIndex (MStatus *ReturnStatus=NULL) const
unsigned int  directionIndex (MStatus *ReturnStatus=NULL) const
unsigned int  startPointIndex (MStatus *ReturnStatus=NULL) const
unsigned int  currentPointIndex (MStatus *ReturnStatus=NULL) const
  MFnDistanceManip (const MObject &object, MStatus *ret=NULL)
  Constructor.

Protected Member Functions

virtual const char *  className () const
  Class name.

Constructor & Destructor Documentation

MFnDistanceManip::~MFnDistanceManip (  )  [virtual]

Destructor.

Class destructor.

MFnDistanceManip::MFnDistanceManip ( 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:

MFnDistanceManip::MFnDistanceManip ( 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:

MFnDistanceManip::MFnDistanceManip ( 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 MFnDistanceManip::type (  )  const [virtual]

Function set type.

Return the class type : MFn::kDistanceManip

Reimplemented from MFnManip3D.

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

Class name.

Return the class name : "MFnDistanceManip"

Reimplemented from MFnManip3D.

MObject MFnDistanceManip::create ( MStatus ReturnStatus = NULL  ) 

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

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

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

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

MObject MFnDistanceManip::create ( const MString manipName,
const MString distanceName,
MStatus ReturnStatus = NULL  
)

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

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

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

Parameters:
[in]  manipName  Name of the manip for UI purposes.
[in]  distanceName  Label for the distance value which appears in the feedback line.
[out]  ReturnStatus  Status code.
Returns:
Newly created DistanceManip.
Status Codes:

Reimplemented from MFnDependencyNode.

MStatus MFnDistanceManip::connectToDistancePlug ( MPlug distancePlug  ) 

Connect to the distance plug. The data type corresponding to the distancePlug is a double. (Note that MFnUnitAttribute::kDistance is used to specify a distance attribute.)

Parameters:
[in]  distancePlug  the distance plug
Returns:
Examples:

MStatus MFnDistanceManip::setStartPoint ( const MPoint startPoint  ) 

Sets the start point of the DistanceManip.

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

MStatus MFnDistanceManip::setDirection ( const MVector direction  ) 

Sets the direction of the DistanceManip.

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

MStatus MFnDistanceManip::setDrawStart ( bool  state  ) 

Sets whether or not to draw the start of the DistanceManip. The start of the DistanceManip 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 MFnDistanceManip::setDrawLine ( bool  state  ) 

Sets whether or not to draw a line from the start to the end of the DistanceManip. By default the line is drawn.

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

MStatus MFnDistanceManip::setScalingFactor ( double  scalingFactor  ) 

Sets the scaling factor. The scaling factor is used to determine how int the DistanceManip appears when it is drawn. The default scaling factor is 1.0.

Parameters:
[in]  scalingFactor  the scaling factor
Returns:

bool MFnDistanceManip::isDrawStartOn ( MStatus ReturnStatus = NULL  )  const

Returns whether or not the start of the DistanceManip is being drawn. By default the start is not drawn.

Parameters:
[out]  ReturnStatus  return status
Returns:
  • true the start of the DistanceManip is being drawn
  • false the start of the DistanceManip is not being drawn
Status Codes:

bool MFnDistanceManip::isDrawLineOn ( MStatus ReturnStatus = NULL  )  const

Returns whether or not a line is being drawn from the start to the end of the DistanceManip. By default the line is drawn.

Parameters:
[out]  ReturnStatus  return status
Returns:
  • true the line of the DistanceManip is being drawn
  • false the line of the DistanceManip is not being drawn
Status Codes:

double MFnDistanceManip::scalingFactor ( MStatus ReturnStatus = NULL  )  const

Returns the scaling factor. The scaling factor is used to determine how int the DistanceManip appears when it is drawn.

Parameters:
[out]  ReturnStatus  return status
Returns:
Scaling factor
Status Codes:

unsigned int MFnDistanceManip::distanceIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the distance. The data type corresponding to this index is a double.

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

unsigned int MFnDistanceManip::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:

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

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

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

unsigned int MFnDistanceManip::currentPointIndex ( MStatus ReturnStatus = NULL  )  const

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

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

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