This command converts subdivision surface components from one or more types to another one or more types, and returns the list of the conversion. It doesn’t change the currently selected objects. Use the “-in/internal” flag to specify conversion to “connected” vs. “contained” components. For example, if the internal flag is specified when converting from subdivision surface vertices to faces, then only faces that are entirely contained by the vertices will be returned. If the internal flag is not specified, then all faces that are connected to the vertices will be returned.
Long name (short name) | Argument Types | Properties | |
---|---|---|---|
border (bo) | bool | ||
fromEdge (fe) | bool | ||
|
|||
fromFace (ff) | bool | ||
|
|||
fromUV (fuv) | bool | ||
|
|||
fromVertex (fv) | bool | ||
|
|||
internal (internal) | bool | ||
Applicable when converting from “smaller” component types to larger ones. Specifies conversion to “connected” vs. “contained” components. See examples below.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list. |
|||
toEdge (te) | bool | ||
|
|||
toFace (tf) | bool | ||
|
|||
toUV (tuv) | bool | ||
|
|||
toVertex (tv) | bool | ||
|
|||
uvShell (uvs) | bool | ||
|
|||
uvShellBorder (uvb) | bool | ||
|
Derived from mel command maya.cmds.subdListComponentConversion
Example:
import pymel.core as pm
import maya.cmds as cmds
pm.subdListComponentConversion( 'subdShape.smp[5][6]', 'subdShape.smp[9][10]', fv=True, tf=True )
# Returns a list of faces that are connected to the given vertices.
pm.subdListComponentConversion( 'subdShape.sme[0][0]', 'subdShape.smp[3][0]', 'subdShape.smp[8][0]', tf=True )
# Returns a list of faces that are connected to the given components.
pm.subdListComponentConversion( 'subdShape.smp[5][9]', fv=True, tf=True, in=True )
# Returns a list of only those faces that are completely contained
# by the given vertices.
pm.select( 'subdShape.smp[0][0]', 'subdShape.smp[3][0]', 'subdShape.smp[8][0]', r=True )
pm.subdListComponentConversion( fv=True, tf=True )
# Returns the conversion of selected vertices to faces.
pm.subdListComponentConversion( 'subdShape.smm[3]', fuv=True, tuv=True, uvs=True )
# Returns a list of all uv map components in the
# same UV shell (contiguous region in texture space).
# (You can view these regions in the UV Texture Editor.)
pm.subdListComponentConversion( 'subdShape.smm[3]', fuv=True, tuv=True, uvb=True )
# Returns a list of the uv map components on the border of the
# same UV shell (contiguous region in texture space). (You can
# view these regions in the UV Texture Editor.)