Go to: Related nodes. Attributes.

 Manage a subdivision surface shape

Node nameParentsMFn typeCompatible function sets
subdivsurfaceShapekSubdivkBase
kNamedObject
kDependencyNode
kDagNode
kShape
kGeometric
kSurface
kSubdiv
kSubdivGeom

Related nodes

subdivToPoly, subdivCollapse, polyToSubdiv, subdivComponentId, nurbsToSubdiv, subdBlindData, subdHierBlind

Attributes (69)

The following quick index only shows top-level attributes (too many attributes to show them all): baseFaceCount, cached, create, depth, dispCreases, dispEdges, dispFaces, dispGeometry, dispMaps, dispResolution, dispUVBorder, dispVertices, dispVerticesAsLimitPoints, displayFilter, displayLevel, edgeCrease, faceUVIds, format, levelOneFaceCount, localizeLimitPointsEdit, mentalRayControls (32), normalsDisplayScale, outSubdiv, sampleCount, scalingHierarchy, textureCoord, vertex (4), vertexTweak (4), worldSubdiv

Long name (short name)TypeDefaultFlags
create (cr) subdivisionSurfaceNULLoutputinputconnectable
The input subdivision surface in local space.
cached (cc) subdivisionSurfaceNULLoutputinputconnectablestorable
Used to store an internal copy of the surface for faster evaluation
dispVertices (dv) boolfalseoutputinputconnectablestorable
Controls explicit CV display
dispVerticesAsLimitPoints (dvl) boolfalseoutputinputconnectable
Control Display of vertices as Limit Points on Surface. Conditional on display vertices.
localizeLimitPointsEdit (llp) boolfalseoutputinputconnectable
Localize edit of more than one limit point. Conditional on display vertices as limit points.
dispEdges (de) boolfalseoutputinputconnectablestorable
Controls explicit edge display
dispFaces (df) boolfalseoutputinputconnectablestorable
Controls explicit face display
dispMaps (dm) boolfalseoutputinputconnectablestorable
Controls explicit UV texture map co-ordinates display
dispUVBorder (db) boolfalseoutputinputconnectablestorable
Controls explicit UV texture map border display
dispCreases (dcr) boolfalseoutputinputconnectablestorable
This attribute currently has no effect in Maya.
dispGeometry (dg) booltrueoutputinputconnectablestorable
Controls explicit geometry display
dispResolution (dr) integer1outputinputconnectablestorable
Controls resolution at which surface is displayed
vertex (vt) compoundn/aarrayoutputinputconnectablekeyable
The attribute for the vertices
singleVertex (svt) double3arrayoutputinputconnectablekeyable
The attribute for the vertices
singleVertexX (svx) distance (double)0cmoutputinputconnectablekeyable
The attribute for the vertices
singleVertexY (svy) distance (double)0cmoutputinputconnectablekeyable
The attribute for the vertices
singleVertexZ (svz) distance (double)0cmoutputinputconnectablekeyable
The attribute for the vertices
vertexTweak (vtw) compoundn/aarrayoutputinputconnectablestorablekeyable
The attribute for the vertex tweaks on shapes with history
singleVertexTweak (stw) double3arrayoutputinputconnectablestorablekeyable
The attribute for the vertex tweaks on shapes with history
singleVertexTweakX (stwx) distance (double)0cmoutputinputconnectablestorablekeyable
The attribute for the vertex tweaks on shapes with history - x value
singleVertexTweakY (stwy) distance (double)0cmoutputinputconnectablestorablekeyable
The attribute for the vertex tweaks on shapes with history - y value
singleVertexTweakZ (stwz) distance (double)0cmoutputinputconnectablestorablekeyable
The attribute for the vertex tweaks on shapes with history - z value
outSubdiv (o) subdivisionSurfaceNULLoutputconnectable
The output subdivision surface.
worldSubdiv (ws) subdivisionSurfaceNULLarrayoutputconnectable
The output subdivision surface in world space.
edgeCrease (ecr) subdivEdgeCreaseNULLoutputinputconnectablestorable
Edge creases
textureCoord (uvs) subdivTextCoordNULLoutputinputconnectablestorable
Texture Coordinates
faceUVIds (fuv) subdivFaceUVIdsNULLarrayoutputinputconnectablestorablehidden
Face corner UV Ids. Explicit UVs on subdiv surfaces are stored on a per-face per-vertex basis. This attribute is used to specify the UV ids on a per-face per-vertex for each UV set that exists on the surface. The values on this attribute are to be used in conjunction with the UVSetPoints attribute defined in the parent controlPointShape class, since that attribute holds on to the uv values corresponding to these ids.
normalsDisplayScale (ndf) double1.0outputinputconnectablestorable
Specifies the scaling factor for the surface normal display.
format (f) enum1outputinputconnectablestorable
Format: 0 - Uniform, 1 - Adaptive (Leaf Level)
depth (d) integer2outputinputconnectablestorable
The depth at which constant-depth tessellates the surface
sampleCount (sc) integer4outputinputconnectablestorable
The number of samples per face
displayLevel (dl) enum0outputinputconnectablestorablekeyable
The level at which components (vertices, edges, faces...) will be displayed. Valid values are 0=Base through 13=Finest.
displayFilter (dfl) enum0outputinputconnectablestorablekeyable
Determines whether diplay includes components "edited" or "visited" at the current display level. Valid values are 0=Edited, 1=Visited, or 2=All.
baseFaceCount (bfc) integer0outputconnectable
The number of base mesh faces
levelOneFaceCount (ofc) integer0outputconnectable
The number of faces at level 1
scalingHierarchy (sh) enum1outputinputconnectablestorable
Controls how scaling of coarser vertices affects finer ones. When set to "Propagate", scaling applied to coarser vertices is propagated to those at finer levels of the hierarchy. This has the effect of making hierarchically-added geometric features scale with the surface as coarser vertices are manipulated. When this attribute is set to "Ignore", scaling applied to coarser vertices is ignored at finer levels of the hierarchy. This has the effect of making hierarchically-added geometric features maintain their size as the rest of the surface is manipulated. Note that this attribute has no effect on scaling applied to the entire object via transforms anywhere above it in the DAG, only to vertices of the surface via component manipulation or (indirectly) via deformations applied to vertices.
mentalRayControls (mrc) compoundn/aoutputinputconnectablestorable
This is a root of following mental ray attributes.
miOverrideCaustics (oca) boolfalseoutputinputconnectablestorable
Enable caustic settings override for this shape. If this parameter is set, the following caustics settings will override the renddr global settings for this shape node.
miCausticAccuracy (caa) short64outputinputconnectablestorable
Caustic accuracy for this shape if miOverrideCaustics is on.
miCausticRadius (car) float0outputinputconnectablestorable
Caustic radius for this shape if miOverrideCaustics is on.
miOverrideGlobalIllumination (ogi) boolfalseoutputinputconnectablestorable
Enable global illumination settings override for this shape. If this parameter is set, the following global illumination settings will override the renddr global settings for this shape node.
miGlobillumAccuracy (gia) short64outputinputconnectablestorable
Global illumination accuracy for this shape if miOverrideGlobalIllumination is on.
miGlobillumRadius (gir) float0outputinputconnectablestorable
Global illumination radius for this shape if miOverrideGlobalIllumination is on.
miOverrideFinalGather (ofg) boolfalseoutputinputconnectablestorable
Enable final gather settings override for this shape. If this parameter is set, the following final gather settings will override the renddr global settings for this shape node.
miFinalGatherRays (fry) integer1000outputinputconnectablestorable
Final gather rays for this shape if miOverrideFinalGather is on.
miFinalGatherMinRadius (fmn) float0outputinputconnectablestorable
Final gather min radius for this shape if miOverrideFinalGather is on.
miFinalGatherMaxRadius (fmx) float0outputinputconnectablestorable
Final gather max radius for this shape if miOverrideFinalGather is on.
miFinalGatherFilter (ffi) short1outputinputconnectablestorable
Final gather filter for this shape if miOverrideFinalGather is on.
miFinalGatherView (fgv) boolfalseoutputinputconnectablestorable
Final gather view flag for this shape if miOverrideFinalGather is on.
miOverrideSamples (oos) boolfalseoutputinputconnectablestorable
Override global object sample settings. In addition to global sample settings mental ray supports per-object sample settings. The global mental ray default for all objects in the scene can be set by minObjectSamples and maxObjectSamples on the mental ray options node (miDefaultOptions). Similar attributes on individual shape nodes miMinSamples and miMaxSamples are overriding the global default, within global samples range.
miMinSamples (mins) short0outputinputconnectablestorable
Specifies min sample settings for the shape. For all pixels that touch this object, at least pow(2, miMinSamples) samples are taken. miMinSamples lower than the global min samples is ignored.
miMaxSamples (maxs) short2outputinputconnectablestorable
Specifies max sample settings for the shape. For all pixels that touch this object, at most pow(2, miMaxSamples) samples are taken. miMaxSamples higher than the global max samples is ignored.
miFinalGatherCast (fgc) booltrueoutputinputconnectablestorable
The object casts final gather rays if miFinalGatherCast is on, which means that the object participates in final gather.
miFinalGatherReceive (fge) booltrueoutputinputconnectablestorable
The object receives final gather rays if miFinalGatherReceive is on, which means that the object is not affected by final gathering.
miTransparencyCast (tpc) booltrueoutputinputconnectablestorable
The object casts transparent rays if miTransparencyCast is on. thus shown through transparent object if ray depth has not been reached the limit.
miTransparencyReceive (tpr) booltrueoutputinputconnectablestorable
The object receives transparent rays if miTransparencyReceive is on.
miReflectionReceive (rflr) booltrueoutputinputconnectablestorable
The object receives reflection rays if miReflectionReceive is on. This flag controls reflection of other objects on this object. If disabled, this object will not show any reflection, as if the surface is not reflective. The casting behaviour is ruled by visibleInReflections flag, which controls reflection of this object on other objects. Disabling visibleInReflections will make this object disappera from reflection.
miRefractionReceive (rfrr) booltrueoutputinputconnectablestorable
The object receives refraction rays if miRefractionReceive is on. This flag contols refraction of other objects through this object. Disabling this value will make this object non-refractive. The casting behaviour is ruled by visibleInRefractions flag, which controls refraction of this object showing through other objects. Disabling visibleInRefractions will make this object disappear from refraction.
miProxyFile (mof) stringNULLoutputinputconnectablestorable
When rendering with mental ray, replace this object with the mental ray assembly file referenced by this attribute.
miUpdateProxyBoundingBoxMode (upbm) enum0outputinputconnectablestorable
Controls how the bounding box attributes for the render proxy are updated when the render proxy file changes. Choices are:
  • Proxy and geometry bounding boxes: both the proxy bounding box and geometry are updated
  • Proxy bounding box only: only the proxy bounding box is updated, the geometry remains the same in the scene
  • Geometry bounding box only: only the geometry changes in the scene, the proxy bounding box attributes are untouched
  • None: Neither proxy bounding box or geometry is changed
miProxyBoundingBox (mbb) compoundn/aoutputinputconnectablestorable
Root for the bounding box attribute of the proxy object
miProxyBoundingBoxMin (mbmn) double3outputinputconnectablestorable
Minimum value of bounding box for proxy object
miProxyBoundingBoxMinX (mbnx) double0.0outputinputconnectablestorable
X value of minimum bounding box for proxy object
miProxyBoundingBoxMinY (mbny) double0.0outputinputconnectablestorable
Y value of minimum bounding box for proxy object
miProxyBoundingBoxMinZ (mbnz) double0.0outputinputconnectablestorable
Z value of minimum bounding box for proxy object
miProxyBoundingBoxMax (mbmx) double3outputinputconnectablestorable
Maximum value of bounding box for proxy object
miProxyBoundingBoxMaxX (mbxx) double0.0outputinputconnectablestorable
X value of maximum bounding box for proxy object
miProxyBoundingBoxMaxY (mbxy) double0.0outputinputconnectablestorable
Y value of maximum bounding box for proxy object
miProxyBoundingBoxMaxZ (mbxz) double0.0outputinputconnectablestorable
Z value of maximum bounding box for proxy object