#include <MFnNumericAttribute.h>
MFnNumericAttribute is the function set for dependency node attributes that store one, two or three untyped numeric values. A numeric attribute supports both a "hard" maximum/minimum and a soft maximum/minimum. The soft maximum/minimum are used by the Attribute Editor as the limits on its slider, but values within the hard range can be typed in the input box.
As a convenience, MFnNumericAttribute will set the flags of child attributes as well when the flags of the parent attribute are set. This is important when creating a numeric pair or triplet. For example, if MFnNumericAttribute is used to create a 3 double attribute and the attribute is set to be keyable, then the three child attributes will also be marked as keyable.
anisotropicShader.cpp, arcLenNode.cpp, backfillShader.cpp, blindDataMesh.cpp, blindShortDataCmd.cpp, brickShader.cpp, buildRotationNode.cpp, cellShader.cpp, cgfxAttrDef.cpp, cgfxShaderNode.cpp, cgfxVector.cpp, checkerShader.cpp, circleNode.cpp, clearcoat.cpp, closestPointOnCurveNode.cpp, compositingShader.cpp, contrastShader.cpp, curvedArrowsNode.cpp, customImagePlane.cpp, cvColorNode.cpp, cvColorShader.cpp, depthShader.cpp, displacementShader.cpp, dynExprField.cpp, flameShader.cpp, gammaShader.cpp, genericAttributeNode.cpp, geometrySurfaceConstraint.cpp, geomShader.cpp, GLSLShaderNode.cpp, hwAnisotropicShader_NV20.cpp, hwColorPerVertexShader.cpp, hwDecalBumpShader_NV20.cpp, hwPhongShader.cpp, hwReflectBumpShader_NV20.cpp, hwRefractReflectShader_NV20.cpp, hwToonShader_NV20.cpp, hwUnlitShader.cpp, interpShader.cpp, jitterNode.cpp, lambertShader.cpp, latticeNoiseNode.cpp, lavaShader.cpp, lightShader.cpp, mixtureShader.cpp, multiCurveNode.cpp, noiseShader.cpp, particleAttrNode.cpp, phongShader.cpp, pnTrianglesNode.cpp, pointOnMeshInfoNode.cpp, pointOnSubdNode.cpp, quadricShape.cpp, renderAccessNode.cpp, rockingTransform.cpp, shadowMatteShader.cpp, shellNode.cpp, shiftNode.cpp, simpleSpring.cpp, sineNode.cpp, slopeShaderNode.cpp, solidCheckerShader.cpp, stringFormatNode.cpp, surfaceBumpManip.cpp, swissArmyManip.cpp, torusField.cpp, transCircleNode.cpp, volumeShader.cpp, weightListNode.cpp, and yTwistNode.cpp.
Public Member Functions | |
virtual MFn::Type | type () const |
Function set type. | |
virtual | ~MFnNumericAttribute () |
Destructor. | |
MFnNumericAttribute () | |
Default constructor. | |
MFnNumericAttribute (MObject &object, MStatus *ReturnStatus=NULL) | |
Constructor. | |
MObject | create (const MString &fullName, const MString &briefName, MFnNumericData::Type unitType, double defaultValue=0, MStatus *ReturnStatus=NULL) |
MObject | createColor (const MString &fullName, const MString &briefName, MStatus *ReturnStatus=NULL) |
MObject | createPoint (const MString &fullName, const MString &briefName, MStatus *ReturnStatus=NULL) |
MObject | createAddr (const MString &fullName, const MString &briefName, void *defaultValue=NULL, MStatus *ReturnStatus=NULL) |
MObject | create (const MString &fullName, const MString &briefName, const MObject &child1, const MObject &child2, const MObject &child3=MObject::kNullObj, MStatus *ReturnStatus=NULL) |
MFnNumericData::Type | unitType (MStatus *ReturnStatus=NULL) const |
MObject | child (unsigned int index, MStatus *ReturnStatus=NULL) const |
bool | hasMin (MStatus *ReturnStatus=NULL) const |
bool | hasMax (MStatus *ReturnStatus=NULL) const |
bool | hasSoftMin (MStatus *ReturnStatus=NULL) const |
bool | hasSoftMax (MStatus *ReturnStatus=NULL) const |
MStatus | getMin (double &min1) const |
MStatus | getMin (double &min1, double &min2) const |
MStatus | getMin (double &min1, double &min2, double &min3) const |
MStatus | getMax (double &max1) const |
MStatus | getMax (double &max1, double &max2) const |
MStatus | getMax (double &max1, double &max2, double &max3) const |
MStatus | getSoftMin (double &min1) const |
MStatus | getSoftMax (double &max1) const |
MStatus | setMin (double min1) |
MStatus | setMin (double min1, double min2) |
MStatus | setMin (double min1, double min2, double min3) |
MStatus | setMax (double max1) |
MStatus | setMax (double max1, double max2) |
MStatus | setMax (double max1, double max2, double max3) |
MStatus | setSoftMin (double min1) |
MStatus | setSoftMax (double max1) |
MStatus | getDefault (bool &def1) |
MStatus | getDefault (char &def1) |
MStatus | getDefault (int &def1) |
MStatus | getDefault (int &def1, int &def2) |
MStatus | getDefault (int &def1, int &def2, int &def3) |
MStatus | getDefault (float &def1) |
MStatus | getDefault (float &def1, float &def2) |
MStatus | getDefault (float &def1, float &def2, float &def3) |
MStatus | getDefault (double &def1) |
MStatus | getDefault (double &def1, double &def2) |
MStatus | getDefault (double &def1, double &def2, double &def3) |
MStatus | getDefault (double &def1, double &def2, double &def3, double &def4) |
MStatus | getDefault (void *&def1) |
MStatus | setDefault (bool def1) |
MStatus | setDefault (char def1) |
MStatus | setDefault (int def1) |
MStatus | setDefault (int def1, int def2) |
MStatus | setDefault (int def1, int def2, int def3) |
MStatus | setDefault (float def1) |
MStatus | setDefault (float def1, float def2) |
MStatus | setDefault (float def1, float def2, float def3) |
MStatus | setDefault (double def1) |
MStatus | setDefault (double def1, double def2) |
MStatus | setDefault (double def1, double def2, double def3) |
MStatus | setDefault (double def1, double def2, double def3, double def4) |
MStatus | setDefault (void *def1) |
MFnNumericAttribute (const MObject &object, MStatus *ReturnStatus=NULL) | |
Constructor. | |
Protected Member Functions | |
virtual const char * | className () const |
Class name. |
Constructor.
Class constructor that initializes the function set to the given MObject.
[in] | object | The MObject to attach the function set to |
[out] | ReturnStatus | the return status |
Constructor.
Class constructor that initializes the function set to the given MObject.
[in] | object | The MObject to attach the function set to |
[out] | ReturnStatus | the return status |
MFn::Type MFnNumericAttribute::type | ( | ) | const [virtual] |
const char * MFnNumericAttribute::className | ( | ) | const [protected, virtual] |
MObject MFnNumericAttribute::create | ( | const MString & | full, | |
const MString & | brief, | |||
MFnNumericData::Type | unitType, | |||
double | defaultValue = 0 , |
|||
MStatus * | ReturnStatus = NULL | |||
) |
Create a new numeric attribute and return it as an MObject. If the attribute create is of a type that stores two or more values, then a compound attribute will be created. The names of child attributes will have "0", "1" and "2" appended to both the full and brief names. As well, each child will use the defaultValue parameter as its default.
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.
[in] | full | the full (or long) name of the attribute |
[in] | brief | the brief (or short) name of the attribute |
[in] | unitType | an element of the MFnUnitAttribute::Type enum |
[in] | defaultValue | the default value for the new attribute |
[out] | ReturnStatus |
MObject MFnNumericAttribute::createColor | ( | const MString & | full, | |
const MString & | brief, | |||
MStatus * | ReturnStatus = NULL | |||
) |
Create a new color attribute and return it as an MObject. The names of child attributes will have "r", "g" and "b" appended to both the full and brief names.
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.
[in] | full | the full (or long) name of the attribute |
[in] | brief | the brief (or short) name of the attribute |
[out] | ReturnStatus |
MObject MFnNumericAttribute::createPoint | ( | const MString & | full, | |
const MString & | brief, | |||
MStatus * | ReturnStatus = NULL | |||
) |
Create a new point attribute and return it as an MObject. The names of child attributes will have "x", "y" and "z" appended to both the full and brief names.
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.
[in] | full | the full (or long) name of the attribute |
[in] | brief | the brief (or short) name of the attribute |
[out] | ReturnStatus |
MObject MFnNumericAttribute::createAddr | ( | const MString & | full, | |
const MString & | brief, | |||
void * | defaultValue = NULL , |
|||
MStatus * | ReturnStatus = NULL | |||
) |
Create a new address attribute and return it as an MObject.
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.
[in] | full | the full (or long) name of the attribute |
[in] | brief | the brief (or short) name of the attribute |
[in] | defaultValue | the default value for the new attribute |
[out] | ReturnStatus |
MObject MFnNumericAttribute::create | ( | const MString & | full, | |
const MString & | brief, | |||
const MObject & | child1, | |||
const MObject & | child2, | |||
const MObject & | child3 = MObject::kNullObj , |
|||
MStatus * | ReturnStatus = NULL | |||
) |
Create a new numeric attribute and return it as an MObject. This form of the create method allows the creation of compound attributes out of numeric attributes. All attributes passed in must be of the same type (eg all of type kDouble). The child1, child2, and child3 (child3 can be ommitted if only two children are desired) parameters represent two numeric attributes created previous via the other form of the create method.
It is also possible to use angle and distance attributes created with MFnUnitAttribute. These attributes will act the same as a double attribute.
[in] | full | the full (or int) name of the attribute |
[in] | brief | the brief (or short) name of the attribute |
[in] | child1 | an MObject representing an numeric attribute |
[in] | child2 | an MObject representing an numeric attribute |
[in] | child3 | an MObject representing an numeric attribute |
[out] | ReturnStatus |
MFnNumericData::Type MFnNumericAttribute::unitType | ( | MStatus * | ReturnStatus = NULL |
) | const |
Return the unit type of this attribute.
[out] | ReturnStatus |
Return the indicated child attribute as an MObject. No index checking is done by this routine, so you must ensure that the index provided is valid.
[in] | index | the full (or int) name of the attribute |
[out] | ReturnStatus |
bool MFnNumericAttribute::hasMin | ( | MStatus * | ReturnStatus = NULL |
) | const |
Determine whether or not this attribute has a minimum value set.
[out] | ReturnStatus |
bool MFnNumericAttribute::hasMax | ( | MStatus * | ReturnStatus = NULL |
) | const |
Determine whether or not this attribute has a maximum value set.
[out] | ReturnStatus |
bool MFnNumericAttribute::hasSoftMin | ( | MStatus * | ReturnStatus = NULL |
) | const |
Determine whether or not this double attribute has a soft minimum value set.
[out] | ReturnStatus |
bool MFnNumericAttribute::hasSoftMax | ( | MStatus * | ReturnStatus = NULL |
) | const |
Determine whether or not this double attribute has a soft maximum value set.
[out] | ReturnStatus |
MStatus MFnNumericAttribute::getMin | ( | double & | min | ) | const |
Return the minimum value for this double attribute.
[out] | min | the minimum value for this attribute |
MStatus MFnNumericAttribute::getMin | ( | double & | min1, | |
double & | min2 | |||
) | const |
Return the minimum values for the two children (both double attributes) of this compound attribute.
[out] | min1 | the minimum value for the first child attribute |
[out] | min2 | the minimum value for the second child attribute |
MStatus MFnNumericAttribute::getMin | ( | double & | min1, | |
double & | min2, | |||
double & | min3 | |||
) | const |
Return the minimum values for the three children (all double attributes) of this compound attribute.
[out] | min1 | the minimum value for the first child attribute |
[out] | min2 | the minimum value for the second child attribute |
[out] | min3 | the minimum value for the third child attribute |
MStatus MFnNumericAttribute::getMax | ( | double & | max | ) | const |
Return the maximum value for this double attribute.
[out] | max | the maximum value for this attribute |
MStatus MFnNumericAttribute::getMax | ( | double & | max1, | |
double & | max2 | |||
) | const |
Return the maximum values for the two children (both double attributes) of this compound attribute.
[out] | max1 | the maximum value for the first child attribute |
[out] | max2 | the maximum value for the second child attribute |
MStatus MFnNumericAttribute::getMax | ( | double & | max1, | |
double & | max2, | |||
double & | max3 | |||
) | const |
Return the maximum values for the three children (all double attributes) of this compound attribute.
[out] | max1 | the maximum value for the first child attribute |
[out] | max2 | the maximum value for the second child attribute |
[out] | max3 | the maximum value for the third child attribute |
MStatus MFnNumericAttribute::getSoftMin | ( | double & | min | ) | const |
Return the minimum value for this double attribute.
[out] | min | the minimum value for this attribute |
MStatus MFnNumericAttribute::getSoftMax | ( | double & | max | ) | const |
Return the maximum value for this double attribute.
[out] | max | the soft maximum value for this attribute |
MStatus MFnNumericAttribute::setMin | ( | double | min | ) |
Set the minimum value for this double attribute.
[in] | min | the minimum value for this attribute |
MStatus MFnNumericAttribute::setMin | ( | double | min1, | |
double | min2 | |||
) |
Set the minimum values for the two children (both double attributes) of this compound attribute.
[in] | min1 | the minimum value for the first child attribute |
[in] | min2 | the minimum value for the second child attribute |
MStatus MFnNumericAttribute::setMin | ( | double | min1, | |
double | min2, | |||
double | min3 | |||
) |
Set the minimum values for the three children (all double attributes) of this compound attribute.
[in] | min1 | the minimum value for the first child attribute |
[in] | min2 | the minimum value for the second child attribute |
[in] | min3 | the minimum value for the third child attribute |
MStatus MFnNumericAttribute::setMax | ( | double | max | ) |
Set the maximum value for this double attribute.
[in] | max | the maximum value for this attribute |
MStatus MFnNumericAttribute::setMax | ( | double | max1, | |
double | max2 | |||
) |
Set the maximum values for the two children (both double attributes) of this compound attribute.
[in] | max1 | the maximum value for the first child attribute |
[in] | max2 | the maximum value for the second child attribute |
MStatus MFnNumericAttribute::setMax | ( | double | max1, | |
double | max2, | |||
double | max3 | |||
) |
Set the maximum values for the three children (all double attributes) of this compound attribute.
[in] | max1 | the maximum value for the first child attribute |
[in] | max2 | the maximum value for the second child attribute |
[in] | max3 | the maximum value for the third child attribute |
MStatus MFnNumericAttribute::setSoftMin | ( | double | min | ) |
Set the soft minimum value for this double attribute.
[in] | min | the minimum value for this attribute |
MStatus MFnNumericAttribute::setSoftMax | ( | double | max | ) |
Set the soft maximum value for this double attribute.
[in] | max | the soft maximum value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | bool & | def1 | ) |
Get the default value for this boolean attribute.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | char & | def1 | ) |
Get the default value for this character attribute.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | int & | def1 | ) |
Gets the default value for this integral attribute. This method is used to get default values for attributes of type byte, short, int or int.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | int & | def1, | |
int & | def2 | |||
) |
Gets the default value for the integral attributes of the two children of this attribute. This method is used to query the default values for attributes of type byte, short, int or int.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | int & | def1, | |
int & | def2, | |||
int & | def3 | |||
) |
Gets the default value for the integral attributes of the three children of this attribute. This method is used to get the default values for attributes of type byte, short, int or int.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
[out] | def3 | returns the default value for third child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | float & | def1 | ) |
Gets the default value for this float attribute.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | float & | def1, | |
float & | def2 | |||
) |
Gets the default value for the float attributes of the two children of this attribute.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | float & | def1, | |
float & | def2, | |||
float & | def3 | |||
) |
Gets the default value for the float attributes of the three children of this attribute.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
[out] | def3 | returns the default value for third child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | double & | def1 | ) |
Get the default value for this double attribute.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::getDefault | ( | double & | def1, | |
double & | def2 | |||
) |
Gets the default value for the double attributes of the two children of this attribute.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | double & | def1, | |
double & | def2, | |||
double & | def3 | |||
) |
Gets the default value for the double attributes of the three children of this attribute.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
[out] | def3 | returns the default value for third child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | double & | def1, | |
double & | def2, | |||
double & | def3, | |||
double & | def4 | |||
) |
Gets the default value for the double attributes of the four children of this attribute.
[out] | def1 | returns the default value for first child of this attribute |
[out] | def2 | returns the default value for second child of this attribute |
[out] | def3 | returns the default value for third child of this attribute |
[out] | def4 | returns the default value for fourth child of this attribute |
MStatus MFnNumericAttribute::getDefault | ( | void *& | def1 | ) |
Get the default value for this address attribute.
[out] | def1 | returns the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | bool | def1 | ) |
Set a new default value for this boolean attribute.
[in] | def1 | new the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | char | def1 | ) |
Set a new default value for this character attribute.
[in] | def1 | new the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | int | def1 | ) |
Set a new default value for this integral attribute. This method is used to set default values for byte, short, int or int attributes.
[in] | def1 | new the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | int | def1, | |
int | def2 | |||
) |
Set a new default value for the integral attributes of the two children of this attribute. This method is used to set default values for byte, short, int or int attributes.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | int | def1, | |
int | def2, | |||
int | def3 | |||
) |
Set a new default value for the integral attributes of the three children of this attribute. This method is used to set default values for byte, short, int or int attributes.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
[in] | def3 | new the default value for third child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | float | def1 | ) |
Set a new default value for this float attribute.
[in] | def1 | new the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | float | def1, | |
float | def2 | |||
) |
Set a new default value for the float attributes of the two children of this attribute.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | float | def1, | |
float | def2, | |||
float | def3 | |||
) |
Set a new default value for the float attributes of the three children of this attribute.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
[in] | def3 | new the default value for third child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | double | def1 | ) |
Set a new default value for this double attribute.
[in] | def1 | new the default value for this attribute |
MStatus MFnNumericAttribute::setDefault | ( | double | def1, | |
double | def2 | |||
) |
Set a new default value for the double attributes of the two children of this attribute.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | double | def1, | |
double | def2, | |||
double | def3 | |||
) |
Set a new default value for the double attributes of the three children of this attribute.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
[in] | def3 | new the default value for third child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | double | def1, | |
double | def2, | |||
double | def3, | |||
double | def4 | |||
) |
Set a new default value for the double attributes of the four children of this attribute.
[in] | def1 | new the default value for first child of this attribute |
[in] | def2 | new the default value for second child of this attribute |
[in] | def3 | new the default value for third child of this attribute |
[in] | def4 | new the default value for fourth child of this attribute |
MStatus MFnNumericAttribute::setDefault | ( | void * | def1 | ) |
Set a new default value for this address attribute.
[in] | def1 | new the default value for this attribute |
Autodesk® Maya® 2009 © 1997-2008 Autodesk, Inc. All rights reserved. | Generated with 1.5.6 |