Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

subdListComponentConversion [-fromEdge] [-fromFace] [-fromUV] [-fromVertex] [-internal] [-toEdge] [-toFace] [-toUV] [-toVertex] [-uvShell] [-uvShellBorder] [objects...]

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.

Return value

string[]List of subdivision surface components

Related

polyListComponentConversion

Flags

fromEdge, fromFace, fromUV, fromVertex, internal, toEdge, toFace, toUV, toVertex, uvShell, uvShellBorder
Long name (short name) Argument types Properties
-fromVertex(-fv) create
Indicates the component type to convert from: Vertex
-fromEdge(-fe) create
Indicates the component type to convert from: Edges
-fromUV(-fuv) create
Indicates the component type to convert from: UVs
-fromFace(-ff) create
Indicates the component type to convert from: Faces
-toVertex(-tv) create
Indicates the component type to convert to: Vertices
-toEdge(-te) create
Indicates the component type to convert to: Edges
-toUV(-tuv) create
Indicates the component type to convert to: UVs
-toFace(-tf) create
Indicates the component type to convert to: Faces
-uvShell(-uvs) create
Will return uv components within the same UV shell. Only works with flags -tuv and -fuv.
-uvShellBorder(-uvb) create
Will return uv components on the border within the same UV shell. Only works with flags -tuv and -fuv.
-internal(-in) create
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 be used more than once in a command.

MEL examples

subdListComponentConversion -fv -tf subdShape.smp[5][6] subdShape.smp[9][10];
// Returns a list of faces that are connected to the given vertices.

subdListComponentConversion -tf subdShape.sme[0][0] subdShape.smp[3][0] subdShape.smp[8][0];
// Returns a list of faces that are connected to the given components.

subdListComponentConversion -fv -tf -in subdShape.smp[5][9];
// Returns a list of only those faces that are completely contained
// by the given vertices.

select -r subdShape.smp[0][0] subdShape.smp[3][0] subdShape.smp[8][0];
subdListComponentConversion -fv -tf;
// Returns the conversion of selected vertices to faces.

subdListComponentConversion -fuv -tuv -uvs subdShape.smm[3];
// 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.)

subdListComponentConversion -fuv -tuv -uvb subdShape.smm[3];
// 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.)