pymel.core.modeling.subdListComponentConversion

subdListComponentConversion(*args, **kwargs)

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/internalflag to specify conversion to connectedvs. containedcomponents. 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.

Flags:
Long name (short name) Argument Types Properties
fromEdge (fe) bool ../../../_images/create.gif
 
Indicates the component type to convert from: Edges
fromFace (ff) bool ../../../_images/create.gif
 
Indicates the component type to convert from: Faces
fromUV (fuv) bool ../../../_images/create.gif
 
Indicates the component type to convert from: UVs
fromVertex (fv) bool ../../../_images/create.gif
 
Indicates the component type to convert from: Vertex
internal (internal) bool ../../../_images/create.gif
 

Applicable when converting from smallercomponent types to larger ones. Specifies conversion to connectedvs. containedcomponents. See examples below. Flag can have multiple arguments, passed either as a tuple or a list.

toEdge (te) bool ../../../_images/create.gif
 
Indicates the component type to convert to: Edges
toFace (tf) bool ../../../_images/create.gif
 
Indicates the component type to convert to: Faces
toUV (tuv) bool ../../../_images/create.gif
 
Indicates the component type to convert to: UVs
toVertex (tv) bool ../../../_images/create.gif
 
Indicates the component type to convert to: Vertices
uvShell (uvs) bool ../../../_images/create.gif
 
Will return uv components within the same UV shell. Only works with flags -tuv and -fuv.
uvShellBorder (uvb) bool ../../../_images/create.gif
 
Will return uv components on the border within the same UV shell. Only works with flags -tuv and -fuv.

Derived from mel command maya.cmds.subdListComponentConversion

Example:

import pymel.core as pm

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.)

Previous topic

pymel.core.modeling.subdLayoutUV

Next topic

pymel.core.modeling.subdMapCut

Core

Core Modules

Other Modules

This Page