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

#include <MFnGenericAttribute.h>

Inheritance diagram for MFnGenericAttribute:

Inheritance graph
[legend]
Collaboration diagram for MFnGenericAttribute:

Collaboration graph
[legend]

List of all members.


Detailed Description

Generic attribute function set.

MFnGenericAttribute is a function set for attributes that can accept several types of data. A generic attribute is similar to a typed attribute (MFnTypedAttribute) except that it has a list of types that it considers valid.

If the attribute will only take one type of data then it is more efficient to use one of the other attribute function sets such as MFnTypedAttribute or MFnNumericAttribute.

Examples:

genericAttributeNode.cpp, and slopeShaderNode.cpp.


Public Member Functions

virtual MFn::Type type () const
 Function set type.
virtual ~MFnGenericAttribute ()
 Destructor.
 MFnGenericAttribute ()
 Default constructor.
 MFnGenericAttribute (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
MObject create (const MString &full, const MString &brief, MStatus *ReturnStatus=NULL)
MStatus addDataAccept (MFnData::Type newType)
MStatus addNumericDataAccept (MFnNumericData::Type newType)
MStatus addAccept (const MTypeId &id)
MStatus removeDataAccept (MFnData::Type oldType)
MStatus removeNumericDataAccept (MFnNumericData::Type oldType)
MStatus removeAccept (const MTypeId &id)
 MFnGenericAttribute (const MObject &object, MStatus *ReturnStatus=NULL)
 Constructor.
MStatus addAccept (MFnData::Type newType)
 Obsolete & no script support.
MStatus addAccept (MFnNumericData::Type newType)
 Obsolete & no script support.
MStatus removeAccept (MFnData::Type oldType)
 Obsolete & no script support.
MStatus removeAccept (MFnNumericData::Type oldType)
 Obsolete & no script support.

Protected Member Functions

virtual const char * className () const
 Class name.

Constructor & Destructor Documentation

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

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

Function set type.

Return the class type : MFn::kGenericAttribute

Reimplemented from MFnAttribute.

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

Class name.

Return the class name : "MFnGenericAttribute"

Reimplemented from MFnAttribute.

MObject MFnGenericAttribute::create ( const MString full,
const MString brief,
MStatus ReturnStatus = NULL 
)

Creates a new generic attribute.

The create method needs to be called on a per node basis. That means if you want to create and add the same attribute to multiple nodes, you need to call the create method for each node to get a unique MObject back. If you call create just once and add the attribute to multiple nodes, Maya will encounter a fatal error.

Parameters:
[in] full int name of the attribute
[in] brief short name of the attribute
Returns:
Status code
Status Codes:
Examples:

MStatus MFnGenericAttribute::addDataAccept ( MFnData::Type  newType  ) 

Add a new connection type that this attribute can accept.

Parameters:
[in] newType new type
Returns:
Status code
Status Codes:

MStatus MFnGenericAttribute::addNumericDataAccept ( MFnNumericData::Type  newType  ) 

Add a new connection type that this attribute can accept.

Parameters:
[in] newType new type
Returns:
Status code
Status Codes:

MStatus MFnGenericAttribute::addAccept ( const MTypeId id  ) 

Add a new connection type that this attribute can accept. This method takes the type id (iff tag) of the data objects that can be accepted.

Parameters:
[in] id id of new type
Returns:
Status code
Status Codes:
Examples:

MStatus MFnGenericAttribute::removeDataAccept ( MFnData::Type  oldType  ) 

Remove one of the types that this attribute can accept.

Parameters:
[in] oldType old type that is no longer accepted
Returns:
Status code
Status Codes:

MStatus MFnGenericAttribute::removeNumericDataAccept ( MFnNumericData::Type  oldType  ) 

Remove one of the types that this attribute can accept.

Parameters:
[in] oldType old type that is no longer accepted
Returns:
Status code
Status Codes:

MStatus MFnGenericAttribute::removeAccept ( const MTypeId id  ) 

Remove one of the types that this attribute can accept. This method takes the type id (iff tag) of the data objects that can no longer be accepted.

Parameters:
[in] id id of old type that is no longer accepted
Returns:
Status code
Status Codes:

MStatus MFnGenericAttribute::addAccept ( MFnData::Type  newType  ) 

Obsolete & no script support.

This method is obsolete. This method is not available in Python.

Deprecated:
Use the MFnGenericAttribute::addDataAccept method instead.

MStatus MFnGenericAttribute::addAccept ( MFnNumericData::Type  newType  ) 

Obsolete & no script support.

This method is obsolete. This method is not available in Python.

Deprecated:
Use the MFnGenericAttribute::addNumericDataAccept method instead.

MStatus MFnGenericAttribute::removeAccept ( MFnData::Type  oldType  ) 

Obsolete & no script support.

This method is obsolete. This method is not available in Python.

Deprecated:
Use the MFnGenericAttribute::removeDataAccept method instead.

MStatus MFnGenericAttribute::removeAccept ( MFnNumericData::Type  oldType  ) 

Obsolete & no script support.

This method is obsolete. This method is not available in Python.

Deprecated:
Use the MFnGenericAttribute::removeNumericDataAccept method instead.


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