polySelectEditCtx

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

Synopsis

polySelectEditCtx [-absoluteOffset boolean] [-adjustEdgeFlow float] [-autoComplete boolean] [-deleteEdge boolean] [-divisions int] [-endVertexOffset float] [-exists] [-fixQuads boolean] [-image1 string] [-image2 string] [-image3 string] [-insertWithEdgeFlow boolean] [-mode int] [-smoothingAngle angle] [-splitType int] [-startVertexOffset float] [-useEqualMultiplier boolean]

polySelectEditCtx is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-adjustEdgeFlow(-aef)	float
The weight value of the edge vertices to be positioned. Default: 1.0f
-divisions(-div)	int
Number of divisions. Default: 2
-exists(-ex)
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-fixQuads(-fq)	boolean
Fixes splits which go across a quad face leaving a 5 and 3 sided faces by splitting from the middle of the new edge to the vertex accross from the edge on the 5 sided face. Default: false
-image1(-i1)	string
First of three possible icons representing the tool associated with the context.
-image2(-i2)	string
Second of three possible icons representing the tool associated with the context.
-image3(-i3)	string
Third of three possible icons representing the tool associated with the context.
-insertWithEdgeFlow(-ief)	boolean
True to enable edge flow. Otherwise, the edge flow is disabled. Default: false
-smoothingAngle(-sma)	angle
Angle below which new edges will be smoothed Default: kPi
-splitType(-stp)	int
Format: 0 - Absolute, 1 - Relative, 2 - Multi Default: TdnpolySplitRing::Relative
-useEqualMultiplier(-uem)	boolean
Changes how the profile curve effects the offset when doing a multisplit. If true then the verts will be offset the same distance based on the shortest edge being split. If false then each inserted edge loop will be offset a distance relative to the length of the edge that is being split. Default: true
Flags from nodes
-absoluteOffset(-abo)	boolean
This flag is deprecated. Use splitType/stp instead. This flag is deprecated. Use splitType/stp instead.
-autoComplete(-ac)	boolean
If true then use auto completion on selections
-deleteEdge(-de)	boolean
When true, the end edges are deleted so the end triangles are converted to quads.
-endVertexOffset(-evo)	float
Weight value controlling the offset of the end vertex of the edgeloop.
-mode(-m)	int
which mode to work on. Available modes are 1-loop and 2-ring
-startVertexOffset(-svo)	float
Weight value controlling the offset of the start vertex of the edgeloop.

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

// Create a poly plane
polyPlane -w 10 -h 10 -sx 5 -sy 5 -n pPlane1;

// Create a new poly select and edit context, then switch to it
polySelectEditCtx polySelectEditCtx1;
setToolTo polySelectEditCtx1;