C++ API Reference
MFnStandardSurfaceShader Class Reference

Manage Standard Surface Shaders. More...

#include <MFnStandardSurfaceShader.h>

+ Inheritance diagram for MFnStandardSurfaceShader:

Public Member Functions

virtual MFn::Type type () const
 Function set type. More...
 
virtual ~MFnStandardSurfaceShader ()
 Destructor.
 
 MFnStandardSurfaceShader ()
 Default constructor.
 
 MFnStandardSurfaceShader (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor. More...
 
MObject create (bool UIvisible=true, MStatus *ReturnStatus=NULL)
 Creates a new standard surface shader dependency graph node and adds it to the dependency graph. More...
 
float base (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "base" attribute of a standard surface shader node. More...
 
MStatus setBase (const float &base)
 Sets the value of the "base" attribute of a shader node. More...
 
MColor baseColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "baseColor" attribute of a standard surface shader node. More...
 
MStatus setBaseColor (const MColor &base_color)
 Sets the value of the "baseColor" attribute of a shader node. More...
 
float diffuseRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "diffuseRoughness" attribute of a standard surface shader node. More...
 
MStatus setDiffuseRoughness (const float &diffuse_roughness)
 Sets the value of the "diffuseRoughness" attribute of a shader node. More...
 
float metalness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "metalness" attribute of a standard surface shader node. More...
 
MStatus setMetalness (const float &metalness)
 Sets the value of the "metalness" attribute of a shader node. More...
 
float specular (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specular" attribute of a standard surface shader node. More...
 
MStatus setSpecular (const float &specular)
 Sets the value of the "specular" attribute of a shader node. More...
 
MColor specularColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specularColor" attribute of a standard surface shader node. More...
 
MStatus setSpecularColor (const MColor &specular_color)
 Sets the value of the "specularColor" attribute of a shader node. More...
 
float specularRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specularRoughness" attribute of a standard surface shader node. More...
 
MStatus setSpecularRoughness (const float &specular_roughness)
 Sets the value of the "specularRoughness" attribute of a shader node. More...
 
float specularIOR (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specularIOR" attribute of a standard surface shader node. More...
 
MStatus setSpecularIOR (const float &specular_i_o_r)
 Sets the value of the "specularIOR" attribute of a shader node. More...
 
float specularAnisotropy (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specularAnisotropy" attribute of a standard surface shader node. More...
 
MStatus setSpecularAnisotropy (const float &specular_anisotropy)
 Sets the value of the "specularAnisotropy" attribute of a shader node. More...
 
float specularRotation (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "specularRotation" attribute of a standard surface shader node. More...
 
MStatus setSpecularRotation (const float &specular_rotation)
 Sets the value of the "specularRotation" attribute of a shader node. More...
 
float transmission (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmission" attribute of a standard surface shader node. More...
 
MStatus setTransmission (const float &transmission)
 Sets the value of the "transmission" attribute of a shader node. More...
 
MColor transmissionColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionColor" attribute of a standard surface shader node. More...
 
MStatus setTransmissionColor (const MColor &transmission_color)
 Sets the value of the "transmissionColor" attribute of a shader node. More...
 
float transmissionDepth (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionDepth" attribute of a standard surface shader node. More...
 
MStatus setTransmissionDepth (const float &transmission_depth)
 Sets the value of the "transmissionDepth" attribute of a shader node. More...
 
MColor transmissionScatter (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionScatter" attribute of a standard surface shader node. More...
 
MStatus setTransmissionScatter (const MColor &transmission_scatter)
 Sets the value of the "transmissionScatter" attribute of a shader node. More...
 
float transmissionScatterAnisotropy (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionScatterAnisotropy" attribute of a standard surface shader node. More...
 
MStatus setTransmissionScatterAnisotropy (const float &transmission_scatter_anisotropy)
 Sets the value of the "transmissionScatterAnisotropy" attribute of a shader node. More...
 
float transmissionDispersion (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionDispersion" attribute of a standard surface shader node. More...
 
MStatus setTransmissionDispersion (const float &transmission_dispersion)
 Sets the value of the "transmissionDispersion" attribute of a shader node. More...
 
float transmissionExtraRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "transmissionExtraRoughness" attribute of a standard surface shader node. More...
 
MStatus setTransmissionExtraRoughness (const float &transmission_extra_roughness)
 Sets the value of the "transmissionExtraRoughness" attribute of a shader node. More...
 
float subsurface (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "subsurface" attribute of a standard surface shader node. More...
 
MStatus setSubsurface (const float &subsurface)
 Sets the value of the "subsurface" attribute of a shader node. More...
 
MColor subsurfaceColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "subsurfaceColor" attribute of a standard surface shader node. More...
 
MStatus setSubsurfaceColor (const MColor &subsurface_color)
 Sets the value of the "subsurfaceColor" attribute of a shader node. More...
 
MColor subsurfaceRadius (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "subsurfaceRadius" attribute of a standard surface shader node. More...
 
MStatus setSubsurfaceRadius (const MColor &subsurface_radius)
 Sets the value of the "subsurfaceRadius" attribute of a shader node. More...
 
float subsurfaceScale (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "subsurfaceScale" attribute of a standard surface shader node. More...
 
MStatus setSubsurfaceScale (const float &subsurface_scale)
 Sets the value of the "subsurfaceScale" attribute of a shader node. More...
 
float subsurfaceAnisotropy (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "subsurfaceAnisotropy" attribute of a standard surface shader node. More...
 
MStatus setSubsurfaceAnisotropy (const float &subsurface_anisotropy)
 Sets the value of the "subsurfaceAnisotropy" attribute of a shader node. More...
 
float coat (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coat" attribute of a standard surface shader node. More...
 
MStatus setCoat (const float &coat)
 Sets the value of the "coat" attribute of a shader node. More...
 
MColor coatColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatColor" attribute of a standard surface shader node. More...
 
MStatus setCoatColor (const MColor &coat_color)
 Sets the value of the "coatColor" attribute of a shader node. More...
 
float coatRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatRoughness" attribute of a standard surface shader node. More...
 
MStatus setCoatRoughness (const float &coat_roughness)
 Sets the value of the "coatRoughness" attribute of a shader node. More...
 
float coatIOR (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatIOR" attribute of a standard surface shader node. More...
 
MStatus setCoatIOR (const float &coat_i_o_r)
 Sets the value of the "coatIOR" attribute of a shader node. More...
 
float coatAnisotropy (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatAnisotropy" attribute of a standard surface shader node. More...
 
MStatus setCoatAnisotropy (const float &coat_anisotropy)
 Sets the value of the "coatAnisotropy" attribute of a shader node. More...
 
float coatRotation (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatRotation" attribute of a standard surface shader node. More...
 
MStatus setCoatRotation (const float &coat_rotation)
 Sets the value of the "coatRotation" attribute of a shader node. More...
 
float coatAffectColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatAffectColor" attribute of a standard surface shader node. More...
 
MStatus setCoatAffectColor (const float &coat_affect_color)
 Sets the value of the "coatAffectColor" attribute of a shader node. More...
 
float coatAffectRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "coatAffectRoughness" attribute of a standard surface shader node. More...
 
MStatus setCoatAffectRoughness (const float &coat_affect_roughness)
 Sets the value of the "coatAffectRoughness" attribute of a shader node. More...
 
float sheen (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "sheen" attribute of a standard surface shader node. More...
 
MStatus setSheen (const float &sheen)
 Sets the value of the "sheen" attribute of a shader node. More...
 
MColor sheenColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "sheenColor" attribute of a standard surface shader node. More...
 
MStatus setSheenColor (const MColor &sheen_color)
 Sets the value of the "sheenColor" attribute of a shader node. More...
 
float sheenRoughness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "sheenRoughness" attribute of a standard surface shader node. More...
 
MStatus setSheenRoughness (const float &sheen_roughness)
 Sets the value of the "sheenRoughness" attribute of a shader node. More...
 
float emission (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "emission" attribute of a standard surface shader node. More...
 
MStatus setEmission (const float &emission)
 Sets the value of the "emission" attribute of a shader node. More...
 
MColor emissionColor (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "emissionColor" attribute of a standard surface shader node. More...
 
MStatus setEmissionColor (const MColor &emission_color)
 Sets the value of the "emissionColor" attribute of a shader node. More...
 
float thinFilmThickness (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "thinFilmThickness" attribute of a standard surface shader node. More...
 
MStatus setThinFilmThickness (const float &thin_film_thickness)
 Sets the value of the "thinFilmThickness" attribute of a shader node. More...
 
float thinFilmIOR (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "thinFilmIOR" attribute of a standard surface shader node. More...
 
MStatus setThinFilmIOR (const float &thin_film_i_o_r)
 Sets the value of the "thinFilmIOR" attribute of a shader node. More...
 
bool thinWalled (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "thinWalled" attribute of a standard surface shader node. More...
 
MStatus setThinWalled (const bool &thin_walled)
 Sets the value of the "thinWalled" attribute of a shader node. More...
 
MColor opacity (MStatus *ReturnStatus=NULL) const
 Retrieves the value of the "opacity" attribute of a standard surface shader node. More...
 
MStatus setOpacity (const MColor &opacity)
 Sets the value of the "opacity" attribute of a shader node. More...
 
 MFnStandardSurfaceShader (const MObject &object, MStatus *ReturnStatus=NULL)
 Constructor. More...
 
- Public Member Functions inherited from MFnDependencyNode
virtual ~MFnDependencyNode ()
 Destructor.
 
 MFnDependencyNode ()
 Default constructor.
 
 MFnDependencyNode (MObject &object, MStatus *ReturnStatus=NULL)
 Constructor. More...
 
MObject create (const MTypeId &typeId, MStatus *ReturnStatus=NULL)
 Creates a new dependency node with the given type tag. More...
 
MObject create (const MTypeId &typeId, const MString &name, MStatus *ReturnStatus=NULL)
 Creates a new dependency node with the given type tag. More...
 
MObject create (const MString &type, MStatus *ReturnStatus=NULL)
 Creates a new dependency node with the given type. More...
 
MObject create (const MString &type, const MString &name, MStatus *ReturnStatus=NULL)
 Creates a new dependency node with the given type. More...
 
MTypeId typeId (MStatus *ReturnStatus=NULL) const
 Returns the type id of this node. More...
 
MString typeName (MStatus *ReturnStatus=NULL) const
 Returns the type name of this node. More...
 
MString name (MStatus *ReturnStatus=NULL) const
 Returns the name of this node. More...
 
MString absoluteName (MStatus *ReturnStatus=NULL) const
 Returns the absolute name of this node. More...
 
MString uniqueName (MStatus *ReturnStatus=NULL) const
 Returns the unique name of this node. More...
 
MString pluginName (MStatus *ReturnStatus=NULL) const
 Returns the name of the plug-in this MFnDependendencyNode was defined in. More...
 
MString setName (const MString &name, bool createNamespace=false, MStatus *ReturnStatus=NULL)
 Sets the name of this node. More...
 
MUuid uuid (MStatus *ReturnStatus=NULL) const
 Returns the node's UUID. More...
 
void setUuid (const MUuid &uuid, MStatus *ReturnStatus=NULL)
 Sets the node's UUID. More...
 
MStatus getConnections (MPlugArray &array) const
 Get all of the current connections to this node as an array of plugs. More...
 
unsigned int attributeCount (MStatus *ReturnStatus=NULL) const
 Returns the number of attributes that this node has. More...
 
MObject attribute (unsigned int index, MStatus *ReturnStatus=NULL) const
 Finds the attribute of this node at the given index. More...
 
MObject reorderedAttribute (unsigned int index, MStatus *ReturnStatus=NULL) const
 Some nodes, such as the various animCurve nodes, require that their attributes be set in a specific order for proper operation. More...
 
MObject attribute (const MString &attrName, MStatus *ReturnStatus=NULL) const
 Finds the attribute of this node that has the given name. More...
 
MAttrClass attributeClass (const MObject &attr, MStatus *ReturnStatus=NULL) const
 Returns the class (normal, dynamic, extension) of the specified attribute. More...
 
MStatus getAffectedAttributes (const MObject &attr, MObjectArray &affectedAttributes) const
 Returns an array of attributes that are affected by the attribute passed in. More...
 
MStatus getAffectedByAttributes (const MObject &attr, MObjectArray &affectedByAttributes) const
 Returns an array of attributes that affect the attribute passed in, attr. More...
 
MPlug findPlug (const MObject &attr, bool wantNetworkedPlug, MStatus *ReturnStatus=NULL) const
 Attempt to find a plug for the given attribute. More...
 
MPlug findPlug (const MString &attrName, bool wantNetworkedPlug, MStatus *ReturnStatus=NULL) const
 Attempt to find a plug for the given attribute. More...
 
MPlug findPlug (const MObject &attr, MStatus *ReturnStatus=NULL) const
 This method is obsolete. More...
 
MPlug findPlug (const MString &attrName, MStatus *ReturnStatus=NULL) const
 This method is obsolete. More...
 
MStatus addAttribute (const MObject &attr)
 Add a new dynamic attibute to this node. More...
 
MStatus removeAttribute (const MObject &attr)
 Remove a dynamic attribute from a node. More...
 
MPxNodeuserNode (MStatus *ReturnStatus=NULL) const
 If the function set's node is a plug-in node, then this method will extract the MPxNode pointer from it. More...
 
bool isFromReferencedFile (MStatus *ReturnStatus=NULL) const
 Indicates whether or not this node came from a referenced file. More...
 
bool isShared (MStatus *ReturnStatus=NULL) const
 Indicates whether or not this node is shared. More...
 
bool isTrackingEdits (MStatus *ReturnStatus=NULL) const
 Returns whether or not edits on the given node are being tracked by the generalized edit system. More...
 
bool hasUniqueName (MStatus *ReturnStatus=NULL) const
 Indicates whether or not this node's name is unique within the scene. More...
 
MString parentNamespace (MStatus *ReturnStatus=NULL) const
 Returns the name of the namespace in which this node resides. More...
 
bool isLocked (MStatus *ReturnStatus=NULL) const
 Indicates whether or not this node is locked. More...
 
MStatus setLocked (bool locked)
 Locks or unlocks this node. More...
 
bool isNewAttribute (const MObject &attr, MStatus *ReturnStatus=NULL) const
 Indicates whether or not the specified attribute was added to this node within the current scene. More...
 
MStatus setFlag (unsigned int flag, bool state)
 Sets the state of the specified flag for the node. More...
 
bool isFlagSet (unsigned int flag, MStatus *ReturnStatus=NULL) const
 Retrieves the current state of the specified flag for a node. More...
 
bool isDefaultNode (MStatus *ReturnStatus=NULL) const
 Returns true if the node is a default node. More...
 
MStatus setDoNotWrite (bool flag)
 Use this method to mark the "do not write" state of this node. More...
 
bool canBeWritten (MStatus *ReturnStatus=NULL) const
 Returns the do not write state of the node. More...
 
bool hasAttribute (const MString &name, MStatus *ReturnStatus=NULL) const
 Returns true if the node already has an attribute with the given name. More...
 
MObject getAliasAttr (bool force, MStatus *ReturnStatus=NULL)
 Returns the node's alias attribute, which is a special attribute used to store information about the node's attribute aliases. More...
 
bool setAlias (const MString &alias, const MString &name, const MPlug &plug, bool add=true, MStatus *ReturnStatus=NULL)
 Sets or removes an alias (i.e. More...
 
bool findAlias (const MString &alias, MObject &attrObj, MStatus *ReturnStatus=NULL) const
 Retrieves the attribute with the given alias. More...
 
bool getAliasList (MStringArray &strArray, MStatus *ReturnStatus=NULL)
 Returns a list of all attribute aliases for this node. More...
 
MString plugsAlias (const MPlug &plug, MStatus *ReturnStatus=NULL)
 Returns the alias for the plug's attribute or the empty string if that attribute has no alias. More...
 
MStatus setIcon (const MString &filename)
 Associates a custom icon with the node for display in the Maya UI. More...
 
MString icon (MStatus *ReturnStatus=NULL) const
 Returns the custom icon filename associated with the node. More...
 
MStatus getExternalContent (MExternalContentInfoTable &table) const
 Returns the external content (files) that this node depends on. More...
 
MStatus addExternalContentForFileAttr (MExternalContentInfoTable &table, const MObject &attr) const
 Adds content info to the specified table from a file path attribute. More...
 
MStatus setExternalContentForFileAttr (const MObject &attr, const MExternalContentLocationTable &table)
 Sets content info in the specified attribute from the table. More...
 
MStatus setExternalContent (const MExternalContentLocationTable &table)
 Changes the location of external content. More...
 
bool affectsAnimation (MStatus *ReturnStatus=NULL) const
 Indicates whether or not this node is allowed to animate. More...
 
MStatus setAffectsAnimation ()
 Define a node can affect animation. More...
 
MString setName (const MString &name, MStatus *ReturnStatus)
 This method is obsolete. More...
 
 MFnDependencyNode (const MObject &object, MStatus *ReturnStatus=NULL)
 This method is not available in Python. More...
 
bool getPlugsAlias (const MPlug &plug, MString &aliasName, MStatus *ReturnStatus=NULL)
 This method is not available in Python. More...
 
virtual const adsk::Data::Associationsmetadata (MStatus *ReturnStatus=NULL) const
 This method is not available in Python. More...
 
virtual MStatus setMetadata (const adsk::Data::Associations &)
 This method is not available in Python. More...
 
virtual MStatus deleteMetadata ()
 This method is not available in Python. More...
 
virtual MStatus validateMetadata (MString &errors) const
 This method is not available in Python. More...
 
MStatus dgTimerOn ()
 Indicates that this node should collect DG timing data whenever DG timing is enabled. More...
 
MStatus dgTimerOff ()
 Indicates that this node should no longer collect DG timing data when DG timing is enabled. More...
 
MdgTimerState dgTimerQueryState (MStatus *ReturnStatus=NULL)
 The function returns the current on/off state of the node's timer. More...
 
MStatus dgTimerReset ()
 The function resets the dependency graph timers and counters for this node to zero. More...
 
double dgTimer (const MdgTimerMetric timerMetric, const MdgTimerType timerType, MStatus *ReturnStatus=NULL) const
 The function returns the specified timer value for the current node. More...
 
MStatus dgCallbacks (const MdgTimerType type, MStringArray &callbackName, MDoubleArray &value)
 Node callbacks that occur when timing is enabled get logged with the node and can be queried via this method. More...
 
MStatus dgCallbackIds (const MdgTimerType type, const MString &callbackName, MCallbackIdArray &callbackId, MDoubleArray &value)
 This method provides a further breakdown of the per-callback time returned via dgCallbacks() by returning the data on a per-callbackId basis. More...
 
MStatus addAttribute (const MObject &attr, MAttrClass type)
 This method is obsolete. More...
 
MStatus removeAttribute (const MObject &attr, MAttrClass type)
 This method is obsolete. 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=nullptr) 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...
 

Static Public Member Functions

static const char * className ()
 Returns the name of this class. More...
 
- Static Public Member Functions inherited from MFnDependencyNode
static const char * className ()
 Returns the name of this class. More...
 
static MString classification (const MString &nodeTypeName)
 Retrieves the classification string for a node type. More...
 
static unsigned int allocateFlag (const MString pluginName, MStatus *ReturnStatus=NULL)
 Allocates a node flag for sole use by the caller. More...
 
static MStatus deallocateFlag (const MString pluginName, unsigned int flag)
 Deallocates a node flag which was previously allocated by a call to allocateFlag. More...
 
static MStatus deallocateAllFlags (const MString pluginName)
 Deallocates all of the node flags which are currently allocated to the specified plugin. More...
 
static void enableDGTiming (bool enable)
 Globally enables or disables the DG node timing mechanism. More...
 
- Static Public Member Functions inherited from MFnBase
static const char * className ()
 Returns the name of this class. More...
 
static const char * typeString (MFn::Type)
 Returns the type string for a given type. More...
 
static bool isValid (MFn::Type)
 Returns true if type is in the range of valid types. More...
 

Additional Inherited Members

- Public Types inherited from MFnDependencyNode
enum  MAttrClass { kLocalDynamicAttr = 1, kNormalAttr, kExtensionAttr, kInvalidAttr }
 Specifies the scope of the attribute. More...
 
enum  MdgTimerState { kTimerOff, kTimerOn, kTimerUninitialized, kTimerInvalidState }
 Possible states for the node's timer. More...
 
enum  MdgTimerMetric {
  kTimerMetric_callback, kTimerMetric_compute, kTimerMetric_dirty, kTimerMetric_draw,
  kTimerMetric_fetch, kTimerMetric_callbackViaAPI, kTimerMetric_callbackNotViaAPI, kTimerMetric_computeDuringCallback,
  kTimerMetric_computeNotDuringCallback, kTimerMetrics
}
 The different timer metrics which can be queried. More...
 
enum  MdgTimerType { kTimerType_self, kTimerType_inclusive, kTimerType_count, kTimerTypes }
 The types of timers which can be queried. More...
 

Detailed Description

Manage Standard Surface Shaders.

MFnStandardSurfaceShader facilitates the creation and manipulation of dependency graph nodes representing standard surface shaders.

Constructor & Destructor Documentation

MFnStandardSurfaceShader ( MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

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

Parameters
[in]objectThe MObject to attach the function set to
[out]ReturnStatusthe 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
MFnStandardSurfaceShader ( const MObject object,
MStatus ReturnStatus = NULL 
)

Constructor.

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

Parameters
[in]objectThe MObject to attach the function set to
[out]ReturnStatusthe 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::kStandardSurface.

Returns
the class type.

Reimplemented from MFnDependencyNode.

OPENMAYA_MAJOR_NAMESPACE_OPEN const char * className ( )
static

Returns the name of this class.

Return the class name : "MFnStandardSurfaceShader".

Returns
Name of this class.
MObject create ( bool  UIvisible = true,
MStatus ReturnStatus = NULL 
)

Creates a new standard surface shader dependency graph node and adds it to the dependency graph.

If the UIvisible parameter is true, the new node will be connected to the shader classification node (which allows the UI to recognize the node as a shader). If UIvisible is false, the node will be created in isolation.

Parameters
[in]UIvisibledetermines whether or not the new node will be connected to the shader classification node.
[out]ReturnStatusreturn status
Returns
MObject representing the new dependency node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInsufficientMemory ran out of memory
  • MS::kNoModelActive no model is currently active
  • MS::kLicenseFailure application not licensed for attempted operation
  • MS::kFailure the new node could not be created, or the new node could not be added to the dependency graph, or the new node could not be connected to the classification node.
float base ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "base" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "base" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setBase ( const float &  base)

Sets the value of the "base" attribute of a shader node.

Parameters
[in]basevalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor baseColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "baseColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "baseColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setBaseColor ( const MColor base_color)

Sets the value of the "baseColor" attribute of a shader node.

Parameters
[in]base_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float diffuseRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "diffuseRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "diffuseRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setDiffuseRoughness ( const float &  diffuse_roughness)

Sets the value of the "diffuseRoughness" attribute of a shader node.

Parameters
[in]diffuse_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float metalness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "metalness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "metalness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setMetalness ( const float &  metalness)

Sets the value of the "metalness" attribute of a shader node.

Parameters
[in]metalnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float specular ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specular" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specular" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecular ( const float &  specular)

Sets the value of the "specular" attribute of a shader node.

Parameters
[in]specularvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor specularColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specularColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specularColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecularColor ( const MColor specular_color)

Sets the value of the "specularColor" attribute of a shader node.

Parameters
[in]specular_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float specularRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specularRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specularRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecularRoughness ( const float &  specular_roughness)

Sets the value of the "specularRoughness" attribute of a shader node.

Parameters
[in]specular_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float specularIOR ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specularIOR" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specularIOR" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecularIOR ( const float &  specular_i_o_r)

Sets the value of the "specularIOR" attribute of a shader node.

Parameters
[in]specular_i_o_rvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float specularAnisotropy ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specularAnisotropy" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specularAnisotropy" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecularAnisotropy ( const float &  specular_anisotropy)

Sets the value of the "specularAnisotropy" attribute of a shader node.

Parameters
[in]specular_anisotropyvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float specularRotation ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "specularRotation" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "specularRotation" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSpecularRotation ( const float &  specular_rotation)

Sets the value of the "specularRotation" attribute of a shader node.

Parameters
[in]specular_rotationvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float transmission ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmission" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmission" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmission ( const float &  transmission)

Sets the value of the "transmission" attribute of a shader node.

Parameters
[in]transmissionvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor transmissionColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionColor ( const MColor transmission_color)

Sets the value of the "transmissionColor" attribute of a shader node.

Parameters
[in]transmission_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float transmissionDepth ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionDepth" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionDepth" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionDepth ( const float &  transmission_depth)

Sets the value of the "transmissionDepth" attribute of a shader node.

Parameters
[in]transmission_depthvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor transmissionScatter ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionScatter" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionScatter" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionScatter ( const MColor transmission_scatter)

Sets the value of the "transmissionScatter" attribute of a shader node.

Parameters
[in]transmission_scattervalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float transmissionScatterAnisotropy ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionScatterAnisotropy" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionScatterAnisotropy" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionScatterAnisotropy ( const float &  transmission_scatter_anisotropy)

Sets the value of the "transmissionScatterAnisotropy" attribute of a shader node.

Parameters
[in]transmission_scatter_anisotropyvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float transmissionDispersion ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionDispersion" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionDispersion" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionDispersion ( const float &  transmission_dispersion)

Sets the value of the "transmissionDispersion" attribute of a shader node.

Parameters
[in]transmission_dispersionvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float transmissionExtraRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "transmissionExtraRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "transmissionExtraRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setTransmissionExtraRoughness ( const float &  transmission_extra_roughness)

Sets the value of the "transmissionExtraRoughness" attribute of a shader node.

Parameters
[in]transmission_extra_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float subsurface ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "subsurface" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "subsurface" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSubsurface ( const float &  subsurface)

Sets the value of the "subsurface" attribute of a shader node.

Parameters
[in]subsurfacevalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor subsurfaceColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "subsurfaceColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "subsurfaceColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSubsurfaceColor ( const MColor subsurface_color)

Sets the value of the "subsurfaceColor" attribute of a shader node.

Parameters
[in]subsurface_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor subsurfaceRadius ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "subsurfaceRadius" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "subsurfaceRadius" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSubsurfaceRadius ( const MColor subsurface_radius)

Sets the value of the "subsurfaceRadius" attribute of a shader node.

Parameters
[in]subsurface_radiusvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float subsurfaceScale ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "subsurfaceScale" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "subsurfaceScale" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSubsurfaceScale ( const float &  subsurface_scale)

Sets the value of the "subsurfaceScale" attribute of a shader node.

Parameters
[in]subsurface_scalevalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float subsurfaceAnisotropy ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "subsurfaceAnisotropy" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "subsurfaceAnisotropy" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSubsurfaceAnisotropy ( const float &  subsurface_anisotropy)

Sets the value of the "subsurfaceAnisotropy" attribute of a shader node.

Parameters
[in]subsurface_anisotropyvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coat ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coat" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coat" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoat ( const float &  coat)

Sets the value of the "coat" attribute of a shader node.

Parameters
[in]coatvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor coatColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatColor ( const MColor coat_color)

Sets the value of the "coatColor" attribute of a shader node.

Parameters
[in]coat_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatRoughness ( const float &  coat_roughness)

Sets the value of the "coatRoughness" attribute of a shader node.

Parameters
[in]coat_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatIOR ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatIOR" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatIOR" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatIOR ( const float &  coat_i_o_r)

Sets the value of the "coatIOR" attribute of a shader node.

Parameters
[in]coat_i_o_rvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatAnisotropy ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatAnisotropy" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatAnisotropy" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatAnisotropy ( const float &  coat_anisotropy)

Sets the value of the "coatAnisotropy" attribute of a shader node.

Parameters
[in]coat_anisotropyvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatRotation ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatRotation" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatRotation" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatRotation ( const float &  coat_rotation)

Sets the value of the "coatRotation" attribute of a shader node.

Parameters
[in]coat_rotationvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatAffectColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatAffectColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatAffectColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatAffectColor ( const float &  coat_affect_color)

Sets the value of the "coatAffectColor" attribute of a shader node.

Parameters
[in]coat_affect_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float coatAffectRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "coatAffectRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "coatAffectRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setCoatAffectRoughness ( const float &  coat_affect_roughness)

Sets the value of the "coatAffectRoughness" attribute of a shader node.

Parameters
[in]coat_affect_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float sheen ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "sheen" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "sheen" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSheen ( const float &  sheen)

Sets the value of the "sheen" attribute of a shader node.

Parameters
[in]sheenvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor sheenColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "sheenColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "sheenColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSheenColor ( const MColor sheen_color)

Sets the value of the "sheenColor" attribute of a shader node.

Parameters
[in]sheen_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float sheenRoughness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "sheenRoughness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "sheenRoughness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setSheenRoughness ( const float &  sheen_roughness)

Sets the value of the "sheenRoughness" attribute of a shader node.

Parameters
[in]sheen_roughnessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float emission ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "emission" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "emission" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setEmission ( const float &  emission)

Sets the value of the "emission" attribute of a shader node.

Parameters
[in]emissionvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor emissionColor ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "emissionColor" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "emissionColor" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setEmissionColor ( const MColor emission_color)

Sets the value of the "emissionColor" attribute of a shader node.

Parameters
[in]emission_colorvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float thinFilmThickness ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "thinFilmThickness" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "thinFilmThickness" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setThinFilmThickness ( const float &  thin_film_thickness)

Sets the value of the "thinFilmThickness" attribute of a shader node.

Parameters
[in]thin_film_thicknessvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
float thinFilmIOR ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "thinFilmIOR" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "thinFilmIOR" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setThinFilmIOR ( const float &  thin_film_i_o_r)

Sets the value of the "thinFilmIOR" attribute of a shader node.

Parameters
[in]thin_film_i_o_rvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
bool thinWalled ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "thinWalled" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "thinWalled" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setThinWalled ( const bool &  thin_walled)

Sets the value of the "thinWalled" attribute of a shader node.

Parameters
[in]thin_walledvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,
MColor opacity ( MStatus ReturnStatus = NULL) const

Retrieves the value of the "opacity" attribute of a standard surface shader node.

Parameters
[out]ReturnStatusreturn status
Returns
The value of the "opacity" attribute of the shader node.
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object.
MStatus setOpacity ( const MColor opacity)

Sets the value of the "opacity" attribute of a shader node.

Parameters
[in]opacityvalue to which the attribute will be set.
Returns
Return status
Status Codes:
  • MS::kSuccess operation successful
  • MS::kFailure function set does not have a valid object,

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