Go to: Synopsis. Return value. Related.
Flags. Python
examples.
polyToSubdiv( [poly] , [absolutePosition=boolean],
[applyMatrixToResult=boolean],
[caching=boolean], [constructionHistory=boolean],
[maxEdgesPerVert=int],
[maxPolyCount=int],
[name=string], [nodeState=int], [object=boolean], [preserveVertexOrdering=boolean],
[quickConvert=boolean],
[uvPoints=[float, float]],
[uvPointsU=float], [uvPointsV=float], [uvTreatment=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
polyToSubdiv is undoable, queryable, and editable.
This command converts a polygon and produces a subd surface. The
name of the new subdivision surface is returned. If construction
history is ON, then the name of the new dependency node is returned
as well.
string |
- the subdivision and optionally the dependency node name |
In query mode, return type is based on queried flag.
changeSubdivComponentDisplayLevel,
changeSubdivRegion, createSubdivRegion, nurbsToSubdiv, querySubdiv, refineSubdivSelectionList,
subdCollapse, subdToBlind, subdToPoly, subdiv,
subdivCrease, subdivDisplaySmoothness
absolutePosition, applyMatrixToResult, caching, constructionHistory, maxEdgesPerVert, maxPolyCount, name,
nodeState, object, preserveVertexOrdering, quickConvert, uvPoints, uvPointsU, uvPointsV, uvTreatment
Long name (short name) |
Argument types |
Properties |
maxPolyCount(mpc) |
int |
|
|
The maximum number of polygons accepted on the input
mesh.
Default: 1000 |
|
maxEdgesPerVert(me) |
int |
|
|
The maximum allowed valence for a vertex on the input
mesh
Default: 32 |
|
applyMatrixToResult(amr) |
boolean |
|
|
If true, the matrix on the input geometry is applied to the
object and the resulting geometry will have identity matrix on it.
If false the conversion is done on the local space object and the
resulting geometry has the input object's matrix on it.
Default: true |
|
absolutePosition(ap) |
boolean |
|
|
If true, the possible blind data information that comes from
the polygon will be treated as absolute positions of the vertices,
instead of the relative offsets. You most likelly just want to use
the default of false, unless you know that the blind data has the
absolute positions in it.
Default: false |
|
uvTreatment(uvt) |
int |
|
|
Treatment of Subd UVs when in proxy mode:
- 0 - preserve Subd UVs
- 1 - build Subd UVs from Poly UVs
- 2 - no UVs on Subd
Default: 0 |
|
uvPoints(uvp) |
[float, float] |
|
|
This is a cached uv point needed to transfer uv data associated
with finer level vertices (when switching between standard editing
mode and poly proxy mode. |
|
uvPointsU(uvu) |
float |
|
|
U value of a cached uv point |
|
uvPointsV(uvv) |
float |
|
|
V value of a cached uv point |
|
preserveVertexOrdering(
pvo) |
boolean |
|
|
Preserve vertex ordering in conversion
Default: true |
|
quickConvert(qc) |
boolean |
|
|
Debug flag to test the performance
Default: true |
|
Advanced flags |
caching(cch) |
boolean |
|
|
Modifies the node caching mode. See the node documentation for
more information.
Note: For advanced users only. |
|
nodeState(nds) |
int |
|
|
Modifies the node state. See the node documentation for more
information.
Note: For advanced users only. |
|
Common flags |
name(n) |
string |
|
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off (where applicable) |
|
object(o) |
boolean |
|
|
Create the result, or just the dep. node (where
applicable) |
|
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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
# To create a new subdivision surface from a polygon:
cmds.polyToSubdiv( 'polySphere1' )
# To create a new subdivision surface from a polygon with history so that
# the tesselation can be edited afterwards:
cmds.polyToSubdiv( 'polySphere1', ch=True )