#include <MFnDoubleIndexedComponent.h>

Class Description

Double indexed component function set.

This function set allows you to create, edit, and query double indexed components. Double indexed components store 2 dimensional index values.

Examples:: listRichSelectionCmd/listRichSelectionCmd.cpp, and paintCallback/paintCallback.cpp.

Inheritance diagram for MFnDoubleIndexedComponent:

Public Member Functions
virtual MFn::Type	type () const
	Function set type. More...

virtual	~MFnDoubleIndexedComponent ()
	Destructor.

	MFnDoubleIndexedComponent ()
	Default constructor.

	MFnDoubleIndexedComponent (MObject &object, MStatus *ReturnStatus=NULL)
	Constructor. More...

MObject	create (MFn::Type compType, MStatus *ReturnStatus=NULL)
	Create a double indexed component of the given type. More...

MStatus	addElement (int uIndex, int vIndex)
	Add the specified element to the component. More...

MStatus	addElements (const MIntArray &uIndexArray, const MIntArray &vIndexArray)
	Add the specified elements to the component. More...

MStatus	getElement (int index, int &uIndex, int &vIndex) const
	Get the specified element from the component. More...

MStatus	getElements (MIntArray &uIndexArray, MIntArray &vIndexArray) const
	Get all of the element indices from the component. More...

MStatus	setCompleteData (int maxU, int maxV)
	Marks the component as complete (meaning all items are selected) and uses the argument to identify the total number of elements selected. More...

MStatus	getCompleteData (int &maxU, int &maxV) const
	Returns the number of elements for the complete component. More...

	MFnDoubleIndexedComponent (const MObject &object, MStatus *ReturnStatus=NULL)
	NO SCRIPT SUPPORT. More...

Public Member Functions inherited from MFnComponent
virtual	~MFnComponent ()
	Destructor.

	MFnComponent (MObject &object, MStatus *ReturnStatus=NULL)
	Constructor. More...

	MFnComponent ()
	Default class constructor.

int	elementCount (MStatus *ReturnStatus=NULL) const
	Returns the number of elements that this component contains. More...

MFn::Type	componentType (MStatus *ReturnStatus=NULL) const
	Returns the MFn type of the component. More...

bool	isEmpty (MStatus *ReturnStatus=NULL) const
	Determines if this component is empty, i.e. More...

bool	isEqual (MObject &, MStatus *ReturnStatus=NULL) const
	Compares this component with the given component. More...

bool	isComplete (MStatus *ReturnStatus=NULL) const
	Returns the complete state of the component. More...

MStatus	setComplete (bool)
	Sets the complete state of the component. More...

bool	hasWeights () const
	Query this component for the existance of attached weight data. More...

MWeight	weight (int index, MStatus *ReturnStatus=NULL) const
	Return the weight data for a given element within this component. More...

MStatus	setWeight (int index, const MWeight &weight)
	Set the weight data for a given element within this component. More...

MStatus	setWeights (const MWeight &weight)
	Set the weight data for all elements within this component. More...

	MFnComponent (const MObject &object, MStatus *ReturnStatus=NULL)
	Constructor. More...

MFn::Type	type (MStatus *ReturnStatus=NULL)
	Obsolete & no script support. More...

Public Member Functions inherited from MFnBase
virtual	~MFnBase ()
	Class Destructor. More...

bool	hasObj (MFn::Type) const
	Determines whether or not the Function Set is compatible with the specified Maya Object within the API RTTI system. More...

bool	hasObj (const MObject &) const
	Determines whether or not the Function Set is compatible with the specified Maya Object within the API RTTI system. More...

MObject	object (MStatus *ReturnStatus=NULL) const
	Returns the MObject that is attached to the Function Set. More...

virtual MStatus	setObject (MObject &object)
	Attaches the Function Set to the specified Maya Object. More...

virtual MStatus	setObject (const MObject &object)
	NO SCRIPT SUPPORT. More...

Protected Member Functions
virtual const char *	className () const
	Class name. More...

Additional Inherited Members
Static Public Member Functions inherited from MFnBase
static const char *	className ()
	Returns the name of this class. More...

Constructor & Destructor Documentation

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

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

MFnDoubleIndexedComponent	(	const MObject &	object,
		MStatus *	ReturnStatus = `NULL`
	)

NO SCRIPT SUPPORT.

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

Constructor

Parameters

[in]	object	The MObject to attach the function set to
[out]	ReturnStatus	the return status

Status Codes:

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

Member Function Documentation

MFn::Type type ( ) const

virtual

Function set type.

Return the class type : MFn::kDoubleIndexedComponent.

Reimplemented from MFnComponent.

const char * className ( ) const

protectedvirtual

Class name.

Return the class name : "MFnDoubleIndexedComponent".

Reimplemented from MFnComponent.

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

Create a double indexed component of the given type.

Allowable types are

MFn::kSurfaceCVComponent MFn::kSurfaceEPComponent MFn::kSurfaceKnotComponent MFn::kMeshVtxFaceComponent

Parameters

[in]	compType	the type of component to create
[out]	ReturnStatus	status code

Returns: The new component

Status Codes:

MS::kSuccess the method was successful.
MS::kInvalidParameter invalid component type

MStatus addElement	(	int	uIndex,
		int	vIndex
	)

Add the specified element to the component.

Parameters

[in]	uIndex	the u index to add
[in]	vIndex	the v index to add

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

MStatus addElements	(	const MIntArray &	uIndices,
		const MIntArray &	vIndices
	)

Add the specified elements to the component.

Parameters

[in]	uIndices	the array of u indices to be added
[in]	vIndices	the array of v indices to be added

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

MStatus getElement	(	int	index,
		int &	uIndex,
		int &	vIndex
	)		const

Get the specified element from the component.

Parameters

[in]	index	the index of the element to retrieve
[out]	uIndex	the u index of the component
[out]	vIndex	the v index of the component

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

MStatus getElements	(	MIntArray &	uIndices,
		MIntArray &	vIndices
	)		const

Get all of the element indices from the component.

Parameters

[out]	uIndices	storage for the array of u indices
[out]	vIndices	storage for the array of v indices

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

Examples:: paintCallback/paintCallback.cpp.

MStatus setCompleteData	(	int	maxU,
		int	maxV
	)

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]	maxU	the maximum number of U elements
[in]	maxV	the maximum number of V elements

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

MStatus getCompleteData	(	int &	maxU,
		int &	maxV
	)		const

Returns the number of elements for the complete component.

A complete component means that all elements are selected.

Parameters

[out]	maxU	storage for the maximum number of U elements
[out]	maxV	storage for the maximum number of V elements

Returns: Status code

Status Codes:

MS::kSuccess the method was successful
MS::kFailure an object error has occurred

The documentation for this class was generated from the following files:

MFnDoubleIndexedComponent.h
MFnDoubleIndexedComponent.cpp

MFnDoubleIndexedComponent Class Reference

Class Description

Public Member Functions

Protected Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation