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

Synopsis

polyListComponentConversion [-border] [-fromEdge] [-fromFace] [-fromUV] [-fromVertex] [-fromVertexFace] [-internal] [-toEdge] [-toFace] [-toUV] [-toVertex] [-toVertexFace] selectionItem[]

polyListComponentConversion is undoable, NOT queryable, and NOT editable.

This command converts poly components from one or more types to another one or more types, and returns the list of the conversion. It doesn't change anything of the current database.

Return value

selectionItem[] List of poly components

Related

polyInstallAction, polySelectConstraint, polySelectConstraintMonitor

Flags

border, fromEdge, fromFace, fromUV, fromVertex, fromVertexFace, internal, toEdge, toFace, toUV, toVertex, toVertexFace
Long name (short name) Argument types Properties
-fromVertex(-fv) create
-fromEdge(-fe) create
-fromUV(-fuv) create
-fromFace(-ff) create
-fromVertexFace(-fvf) create
Indicates the component type to convert from. If none of them is provided, it is assumed to be all of them, including poly objects.
-toVertex(-tv) create
-toEdge(-te) create
-toUV(-tuv) create
-toFace(-tf) create
-toVertexFace(-tvf) create
Indicates the component type to convert to. If none of them is provided, it is assumed to the object.
-internal(-in) create
Indicates that the converted components must be totally envolved by the source components. E.g. a converted face must have all of its surrounding vertices being given. If it is not provided, the converted components will be the related ones.
-border(-bo) create
Indicates that the converted components must be on the border of the selection. If it is not provided, the converted components will be the related ones.

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

// Convert the vertices to envolved poly face(s) and list results.
//
polyListComponentConversion -fv -tf -in plg.vtx[5:6] plg.vtx[9:10];
// Result: plg.f[4] //

// Convert anything to related poly face(s) and list results.
//
polyListComponentConversion -tf plg.vtx[0] plg.vtx[3] plg.vtx[8];
// Result: plg.f[0] plg.f[2] plg.f[3] plg.f[6] //

// Convert an object to faces and list results.
//
polyListComponentConversion    -tf plg;
// Result: plg.f[*] //

//  convert vertices to faces on selectionList and list results.
//
select -r plg.vtx[0] plg.vtx[3] plg.vtx[8];
polyListComponentConversion -fv -tf;
// Result: plg.f[0] plg.f[2] plg.f[3] plg.f[6] //