Go to: Synopsis. Return value. Related. Flags. Python examples.
subdListComponentConversion(
[objects...]
, [fromEdge=boolean], [fromFace=boolean], [fromUV=boolean], [fromVertex=boolean], [internal=boolean], [toEdge=boolean], [toFace=boolean], [toUV=boolean], [toVertex=boolean], [uvShell=boolean], [uvShellBorder=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
subdListComponentConversion is undoable, NOT queryable, and NOT editable.
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.
| string[] | List of subdivision surface components |
polyListComponentConversion
fromEdge, fromFace, fromUV, fromVertex, internal, toEdge, toFace, toUV, toVertex, uvShell, uvShellBorder
| Long name (short name) |
Argument types |
Properties |
fromVertex(fv)
|
boolean
|
|
|
Indicates the component type to convert
from: Vertex
|
|
fromEdge(fe)
|
boolean
|
|
|
Indicates the component type to convert
from: Edges
|
|
fromUV(fuv)
|
boolean
|
|
|
Indicates the component type to convert
from: UVs
|
|
fromFace(ff)
|
boolean
|
|
|
Indicates the component type to convert
from: Faces
|
|
toVertex(tv)
|
boolean
|
|
|
Indicates the component type to convert
to: Vertices
|
|
toEdge(te)
|
boolean
|
|
|
Indicates the component type to convert
to: Edges
|
|
toUV(tuv)
|
boolean
|
|
|
Indicates the component type to convert
to: UVs
|
|
toFace(tf)
|
boolean
|
|
|
Indicates the component type to convert
to: Faces
|
|
uvShell(uvs)
|
boolean
|
|
|
Will return uv components within the same UV
shell. Only works with flags -tuv and -fuv.
|
|
uvShellBorder(uvb)
|
boolean
|
|
|
Will return uv components on the border
within the same UV shell. Only works with
flags -tuv and -fuv.
|
|
internal(internal)
|
boolean
|
|
|
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 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
cmds.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.
cmds.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.
cmds.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.
cmds.select( 'subdShape.smp[0][0]', 'subdShape.smp[3][0]', 'subdShape.smp[8][0]', r=True )
cmds.subdListComponentConversion( fv=True, tf=True )
# Returns the conversion of selected vertices to faces.
cmds.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.)
cmds.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.)