pymel.core.modeling.subdToPoly

subdToPoly(*args, **kwargs)

This command tessellates a subdivision surface and produces polygon. The name of the new polygon is returned. If construction history is ON, then the name of the new dependency node is returned as well.

Flags:
Long name (short name) Argument Types Properties
addUnderTransform (aut) bool  
   
applyMatrixToResult (amr) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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:trueAdvanced flags

caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
connectShaders (cs) bool ../../../_images/create.gif
 

If true, all shader assignment will be copied from the original subdiv surface to the converted polygonal surface.Default:trueFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off (where applicable)
copyUVTopology (cut) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Copy over uv topology (shared/unshared) from the original subdivision surface to the converted polygonal mesh.Default:false
depth (d) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The depth at which constant-depth tessellates the surfaceDefault:0
extractPointPosition (epp) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Determines how the position of a mesh point is calculated If on the position of the mesh point is returned. If off the position of the point of the surface is returned.Default:false

format (f) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Format: 0 - Uniform1 - Adaptive2 - Polygon Count3 - VerticesDefault:0
inSubdCVId (inSubdCVId) int, int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Input CV Id
inSubdCVIdLeft (isl) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Higher 32 bit integer of the input CV Id
inSubdCVIdRight (isr) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Lower 32 bit integer of the input CV Id
maxPolys (mp) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

The maximum number of polygons at which by polygons tessellates. If this attribute is greater than zero, it will override the sample count and depth attributes.Default:0

name (n) unicode ../../../_images/create.gif
 
Name the resulting object
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dep. node (where applicable)
outSubdCVId (os) int, int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Output CV Id
outSubdCVIdLeft (osl) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Higher 32 bit integer of the output CV Id
outSubdCVIdRight (osr) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Lower 32 bit integer of the output CV Id
outv (ov) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Out Vertices corresponding to the inSubDCVs.
preserveVertexOrdering (pvo) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Preserve vertex ordering in conversionDefault:true
sampleCount (sc) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The number of samples per faceDefault:1
shareUVs (suv) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Force sharing of uvs on all common vertices - the value of this attribute gets overridden by the value of the copyUVTopology attribute.Default:false
subdNormals (un) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Keep subdiv surface normalsDefault:false

Derived from mel command maya.cmds.subdToPoly

Example:

import pymel.core as pm

# To create a new polygon from a subdivision surface:
pm.subdToPoly( 'subd1' )

Previous topic

pymel.core.modeling.subdToBlind

Next topic

pymel.core.modeling.subdTransferUVsToCache

Core

Core Modules

Other Modules

This Page