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
	Indicates the component type to convert from: Edges
fromFace (ff)		bool
	Indicates the component type to convert from: Faces
fromUV (fuv)		bool
	Indicates the component type to convert from: UVs
fromVertex (fv)		bool
	Indicates the component type to convert from: Vertex
internal (internal)		bool
	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
	Indicates the component type to convert to: Edges
toFace (tf)		bool
	Indicates the component type to convert to: Faces
toUV (tuv)		bool
	Indicates the component type to convert to: UVs
toVertex (tv)		bool
	Indicates the component type to convert to: Vertices
uvShell (uvs)		bool
	Will return uv components within the same UV shell. Only works with flags -tuv and -fuv.
uvShellBorder (uvb)		bool
	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.)