MFnSingleIndexedComponent Class Reference
[OpenMaya - API module for common classesFunctionSet classes]

#include <MFnSingleIndexedComponent.h>

Inheritance diagram for MFnSingleIndexedComponent:

Inheritance graph
[legend]
Collaboration diagram for MFnSingleIndexedComponent:

Collaboration graph
[legend]

List of all members.


Detailed Description

Single indexed component function set.

This function set allows you to create, edit, and query single indexed components. Single indexed components store 1 dimensional index values.

Examples:

apiMeshData.cpp, apiMeshShape.cpp, apiMeshShapeUI.cpp, apiSimpleShapeUI.cpp, meshOpCmd.cpp, meshOpNode.cpp, OpenGLViewportRenderer.cpp, splitUVCmd.cpp, and splitUVNode.cpp.


Public Member Functions

virtual MFn::Type type () const
 Function set type.
virtual ~MFnSingleIndexedComponent ()
 Destructor.
 MFnSingleIndexedComponent ()
 Default constructor.
 MFnSingleIndexedComponent (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
MObject create (MFn::Type compType, MStatus *ReturnStatus=NULL)
MStatus addElement (int element)
MStatus addElements (MIntArray &elements)
int element (int index, MStatus *ReturnStatus=NULL) const
MStatus getElements (MIntArray &elements) const
MStatus setCompleteData (int numElements)
MStatus getCompleteData (int &numElements) const
 MFnSingleIndexedComponent (const MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.

Protected Member Functions

virtual const char * className () const
 Class name.

Constructor & Destructor Documentation

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

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

Function set type.

Return the class type : MFn::kSingleIndexedComponent

Reimplemented from MFnComponent.

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

Class name.

Return the class name : "MFnSingleIndexedComponent"

Reimplemented from MFnComponent.

MObject MFnSingleIndexedComponent::create ( MFn::Type  compType,
MStatus ReturnStatus = NULL 
)

Create a single indexed component of the given type. Allowable types are

MFn::kCurveCVComponent MFn::kCurveEPComponent MFn::kCurveKnotComponent MFn::kMeshEdgeComponent MFn::kMeshPolygonComponent MFn::kMeshVertComponent MFn::kMeshMapComponent

Parameters:
[in] compType the type of component to create
[out] ReturnStatus status code
Returns:
The new component
Status Codes:
Examples:

MStatus MFnSingleIndexedComponent::addElement ( int  element  ) 

Add the specified element to the component.

Parameters:
[in] element the element index to be added
Returns:
Status code
Status Codes:
Examples:

MStatus MFnSingleIndexedComponent::addElements ( MIntArray elements  ) 

Add the specified elements to the component.

Parameters:
[in] elements the array of element indices to be added
Returns:
Status code
Status Codes:
Examples:

int MFnSingleIndexedComponent::element ( int  index,
MStatus ReturnStatus = NULL 
) const

Returns the specified element from the component.

Parameters:
[in] index the index of the element to retrieve
[out] ReturnStatus status code
Returns:
The index of the specified component
Status Codes:

MStatus MFnSingleIndexedComponent::getElements ( MIntArray elements  )  const

Get all of the element indices from the component.

Parameters:
[out] elements storage for the array of indices
Returns:
Status code
Status Codes:

MStatus MFnSingleIndexedComponent::setCompleteData ( int  numElements  ) 

Marks the component as complete (meaning all items are selected) and uses the argument to identify the total number of elements selected. If the component should contain N element indices, then the range would be [0,N-1].

Also sets the complete state of the component to 'true' (i.e. setComplete(true)).

Parameters:
[in] numElements the maximum number of elements in the component
Returns:
Status code
Status Codes:
Examples:

MStatus MFnSingleIndexedComponent::getCompleteData ( int &  numElements  )  const

Returns the number of elements for the complete component. A complete component means that all elements are selected.

Parameters:
[out] numElements storage for the maximum number of elements
Returns:
Status code
Status Codes:


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