Go to: Related nodes. Attributes.

Manage a subdivision surface shape

Node nameParentsClassificationMFn typeCompatible function sets
subdivsurfaceShapedrawdb/geometry/subdivkSubdivkBase
kNamedObject
kDependencyNode
kDagNode
kShape
kGeometric
kSurface
kSubdiv
kSubdivGeom

Related nodes

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

Attributes (36)

baseFaceCount, cached, create, depth, dispCreases, dispEdges, dispFaces, dispGeometry, dispMaps, dispResolution, dispUVBorder, dispVertices, dispVerticesAsLimitPoints, displayFilter, displayLevel, edgeCrease, faceUVIds, format, levelOneFaceCount, localizeLimitPointsEdit, normalsDisplayScale, outSubdiv, sampleCount, scalingHierarchy, singleVertex, singleVertexTweak, singleVertexTweakX, singleVertexTweakY, singleVertexTweakZ, singleVertexX, singleVertexY, singleVertexZ, textureCoord, vertex, vertexTweak, 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.