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

Synopsis

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

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polySelectEditCtx is undoable, queryable, and editable.

Create a new context to select and edit polygonal objects

Return value

stringThe context name

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

Flags

absoluteOffset, adjustEdgeFlow, autoComplete, deleteEdge, divisions, endVertexOffset, exists, fixQuads, image1, image2, image3, insertWithEdgeFlow, mode, smoothingAngle, splitType, startVertexOffset, useEqualMultiplier
Long name (short name) Argument types Properties
adjustEdgeFlow(aef) float createqueryedit
The weight value of the edge vertices to be positioned.
Default: 1.0f
divisions(div) int createqueryedit
Number of divisions.
Default: 2
exists(ex) boolean create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
fixQuads(fq) boolean createqueryedit
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 createqueryedit
First of three possible icons representing the tool associated with the context.
image2(i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
image3(i3) string createqueryedit
Third of three possible icons representing the tool associated with the context.
insertWithEdgeFlow(ief) boolean createqueryedit
True to enable edge flow. Otherwise, the edge flow is disabled.
Default: false
smoothingAngle(sma) angle createqueryedit
Angle below which new edges will be smoothed
Default: kPi
splitType(stp) int createqueryedit
Format: 0 - Absolute, 1 - Relative, 2 - Multi
Default: TdnpolySplitRing::Relative
useEqualMultiplier(uem) boolean createqueryedit
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 createqueryedit
This flag is deprecated. Use splitType/stp instead. This flag is deprecated. Use splitType/stp instead.
autoComplete(ac) boolean create
If true then use auto completion on selections
deleteEdge(de) boolean createqueryedit
When true, the end edges are deleted so the end triangles are converted to quads.
endVertexOffset(evo) float createqueryedit
Weight value controlling the offset of the end vertex of the edgeloop.
mode(m) int createqueryedit
which mode to work on. Available modes are 1-loop and 2-ring
startVertexOffset(svo) float createqueryedit
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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Create a poly plane
cmds.polyPlane(w=10, h=10, sx=5, sy=5, n='pPlane1')

# Create a new poly select and edit context, then switch to it
cmds.polySelectEditCtx('polySelectEditCtx1')
cmds.setToolTo('polySelectEditCtx1')