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

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

List of all members.


Detailed Description

PointOnSurfaceManip function set.

The PointOnSurfaceManip allows the user to manipulate a point constrained to move along a surface, in order to specify the (u, v) surface parameter values. This manipulator generates two floating point values corresponding to the surface (u, v) parameters.

Examples:

surfaceBumpManip.cpp.


Public Member Functions

virtual MFn::Type  type () const
  Function set type.
virtual  ~MFnPointOnSurfaceManip ()
  Destructor.
  MFnPointOnSurfaceManip ()
  Default constructor.
  MFnPointOnSurfaceManip (MObject &object, MStatus *ReturnStatus=NULL)
  Constructor.
  MFnPointOnSurfaceManip (const MDagPath &object, MStatus *ret=NULL)
  Constructor.
MObject  create (MStatus *ReturnStatus=NULL)
MObject  create (const MString &manipName, const MString &paramName, MStatus *ReturnStatus=NULL)
MStatus  connectToSurfacePlug (MPlug &surfacePlug)
MStatus  connectToParamPlug (MPlug &paramPlug)
MStatus  setDrawSurface (bool state)
MStatus  setDrawArrows (bool state)
MStatus  setParameters (double u, double v)
MStatus  getParameters (double &u, double &v)
bool  isDrawSurfaceOn (MStatus *ReturnStatus=NULL) const
unsigned int  surfaceIndex (MStatus *ReturnStatus=NULL) const
unsigned int  paramIndex (MStatus *ReturnStatus=NULL) const
  MFnPointOnSurfaceManip (const MObject &object, MStatus *ret=NULL)
  Constructor.

Protected Member Functions

virtual const char *  className () const
  Class name.

Constructor & Destructor Documentation

MFnPointOnSurfaceManip::~MFnPointOnSurfaceManip (  )  [virtual]

Destructor.

Class destructor.

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

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

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

Function set type.

Return the class type : MFn::kPointOnSurfaceManip

Reimplemented from MFnManip3D.

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

Class name.

Return the class name : "MFnPointOnSurfaceManip"

Reimplemented from MFnManip3D.

MObject MFnPointOnSurfaceManip::create ( MStatus ReturnStatus = NULL  ) 

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

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

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

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

MObject MFnPointOnSurfaceManip::create ( const MString manipName,
const MString paramName,
MStatus ReturnStatus = NULL  
)

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

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

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

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

Reimplemented from MFnDependencyNode.

MStatus MFnPointOnSurfaceManip::connectToSurfacePlug ( MPlug surfacePlug  ) 

Connect to the surface plug. The data type corresponding to the surfacePlug is MFnData::kNurbsSurface.

Parameters:
[in]  surfacePlug  the surface plug
Returns:

MStatus MFnPointOnSurfaceManip::connectToParamPlug ( MPlug paramPlug  ) 

Connect to the param plug. The data type corresponding to the paramPlug is MFnNumericData::k2Double.

Parameters:
[in]  paramPlug  the param plug
Returns:

MStatus MFnPointOnSurfaceManip::setDrawSurface ( bool  state  ) 

Sets whether or not the surface is drawn.

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

MStatus MFnPointOnSurfaceManip::setDrawArrows ( bool  state  ) 

Sets whether or not the arrows should be drawn.

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

MStatus MFnPointOnSurfaceManip::setParameters ( double  u,
double  v  
)

Sets the u and v parameters.

Parameters:
[in]  u  u parameter
[in]  v  v parameter
Returns:

MStatus MFnPointOnSurfaceManip::getParameters ( double &  u,
double &  v  
)

Returns the parameter.

Parameters:
[out]  u  u parameter
[out]  v  v parameter
Returns:

bool MFnPointOnSurfaceManip::isDrawSurfaceOn ( MStatus ReturnStatus = NULL  )  const

Returns whether or not the surface is drawn.

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

unsigned int MFnPointOnSurfaceManip::surfaceIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the surface. The data type corresponding to this index is MFnData::kNurbsSurface.

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

unsigned int MFnPointOnSurfaceManip::paramIndex ( MStatus ReturnStatus = NULL  )  const

Returns the index of the parameter of the PointOnSurfaceManip. The data type corresponding to this index is MFnNumericData::k2Double.

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

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