Go to: Synopsis. Return value. Related. Flags. MEL examples.
getClassification [-satisfies string]
string
getClassification is undoable, NOT queryable, and NOT editable.
Returns the classification string for a given node type.
Classification strings look like file pathnames ("shader/reflective" or "texture/2D", for
example). Multiple classifications can be combined into a single compound
classification string by joining the individual classifications with ':'.
For example, the classification string "shader/reflective:texture/2D" means
that the node is both a reflective shader and a 2D texture.
The classification string is used to determine how rendering nodes
are categorized in various UI, such as the Create Render Node and HyperShade
windows:
| Category | Classification String |
|---|
| 2D Textures | "texture/2d" |
| 3D Textures | "texture/3d" |
| Env Textures | "texture/environment" |
| Surface Materials | "shader/surface" |
| Volumetric Materials | "shader/volume" |
| Displacement Materials | "shader/displacement" |
| Lights | "light" |
| General Utilities | "utility/general" |
| Color Utilities | "utility/color |
| Particle Utilities | "utility/particle" |
| Image Planes | "imageplane" |
| Glow | "postprocess/opticalFX" |
The classification string is also used to determine how Viewport 2.0
will interpret the node.
| Category | Classification String |
|---|
| Geometry | "drawdb/geometry" |
| Transform | "drawdb/geometry/transform" |
| Sub-Scene Object | "drawdb/subscene" |
| Shader | "drawdb/shader" |
| Surface Shader | "drawdb/shader/surface" |
| string[] | Returns the classification strings for the given node type, or
an empty array if the node type is not classified. |
addAttr, aliasAttr, attributeInfo, deleteAttr, listNodeTypes, nodeType, objExists, objectType, renameAttr
satisfies
| Long name (short name) |
Argument types |
Properties |
-satisfies(-sat)
|
string
|
|
|
Returns true if the given node type's classification satisfies the classification
string which is passed with the flag.
A non-compound classification string A is said to satisfy a non-compound
classification string B if A is a subclassification of B (for example,
"shaders/reflective" satisfies "shaders").
A compound classification string A satisfies a compound classification
string B iff:
- every component of A satisfies at least one component of B and
- every component of B is satisfied by at least one component of A
Hence, "shader/reflective/phong:texture" satisfies "shader:texture", but
"shader/reflective/phong" does not satisfy "shader:texture".
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
Flag can appear in Query mode of command
|
Flag can be used more than once in a command.
|
// Get the classification string for the "lambert" node type
//
string $classifications[] = `getClassification "lambert"`;
for ($c in $classifications)
{ print("\tClassified as "+$c+"\n"); }
int $isShader = `getClassification -satisfies "shader" "lambert"`;