Go to: Synopsis. Return value. Related. Flags. MEL examples.
polySelectConstraint [-angle int] [-anglePropagation boolean] [-angleTolerance float] [-anglebound angle angle] [-border boolean] [-borderPropagation boolean] [-convexity int] [-crease boolean] [-disable] [-dist int] [-distaxis float float float] [-distbound float float] [-distpoint float float float] [-edgeDistance uint] [-geometricarea int] [-geometricareabound float float] [-holes int] [-length int] [-lengthbound float float] [-loopPropagation boolean] [-max2dAngle float] [-max3dAngle float] [-mode int] [-nonmanifold int] [-oppositeEdges boolean] [-order int] [-orderbound int int] [-orient int] [-orientaxis float float float] [-orientbound float float] [-planarity int] [-propagate int] [-random int] [-randomratio float] [-returnSelection boolean] [-ringPropagation boolean] [-shell boolean] [-size int] [-smoothness int] [-stateString] [-textured int] [-texturedarea int] [-texturedareabound float float] [-textureshared int] [-topology int] [-type int] [-uvBorderSelection boolean] [-uvConstraint boolean] [-uvEdgeLoopPropagation boolean] [-uvEdgeRingPropagation boolean] [-uvFaceOrientation int] [-uvShell boolean] [-visibility int] [-visibilityangle angle] [-visibilitypoint float float float] [-where int] [-wholeSensitive boolean]
polySelectConstraint is undoable, queryable, and NOT editable.
Changes the global polygonal selection constraints.None
In query mode, return type is based on queried flag.
Long name (short name) | Argument types | Properties | ||
---|---|---|---|---|
-angle(-a)
|
int
|
|||
|
||||
-anglePropagation(-ap)
|
boolean
|
|||
|
||||
-angleTolerance(-at)
|
float
|
|||
|
||||
-anglebound(-ab)
|
angle angle
|
|||
|
||||
-border(-bo)
|
boolean
|
|||
|
||||
-borderPropagation(-bp)
|
boolean
|
|||
|
||||
-convexity(-c)
|
int
|
|||
|
||||
-crease(-cr)
|
boolean
|
|||
|
||||
-disable(-dis)
|
|
|||
|
||||
-dist(-d)
|
int
|
|||
|
||||
-distaxis(-da)
|
float float float
|
|||
|
||||
-distbound(-db)
|
float float
|
|||
|
||||
-distpoint(-dp)
|
float float float
|
|||
|
||||
-edgeDistance(-ed)
|
uint
|
|||
|
||||
-geometricarea(-ga)
|
int
|
|||
|
||||
-geometricareabound(-gab)
|
float float
|
|||
|
||||
-holes(-h)
|
int
|
|||
|
||||
-length(-l)
|
int
|
|||
|
||||
-lengthbound(-lb)
|
float float
|
|||
|
||||
-loopPropagation(-lp)
|
boolean
|
|||
|
||||
-max2dAngle(-m2a)
|
float
|
|||
|
||||
-max3dAngle(-m3a)
|
float
|
|||
|
||||
-mode(-m)
|
int
|
|||
|
||||
-nonmanifold(-nm)
|
int
|
|||
|
||||
-oppositeEdges(-oe)
|
boolean
|
|||
|
||||
-order(-or)
|
int
|
|||
|
||||
-orderbound(-orb)
|
int int
|
|||
|
||||
-orient(-o)
|
int
|
|||
|
||||
-orientaxis(-oa)
|
float float float
|
|||
|
||||
-orientbound(-ob)
|
float float
|
|||
|
||||
-planarity(-p)
|
int
|
|||
|
||||
-propagate(-pp)
|
int
|
|||
|
||||
-random(-r)
|
int
|
|||
|
||||
-randomratio(-rr)
|
float
|
|||
|
||||
-returnSelection(-rs)
|
boolean
|
|||
|
||||
-ringPropagation(-rp)
|
boolean
|
|||
|
||||
-shell(-sh)
|
boolean
|
|||
|
||||
-size(-sz)
|
int
|
|||
|
||||
-smoothness(-sm)
|
int
|
|||
|
||||
-stateString(-sts)
|
|
|||
|
||||
-textured(-tx)
|
int
|
|||
|
||||
-texturedarea(-ta)
|
int
|
|||
|
||||
-texturedareabound(-tab)
|
float float
|
|||
|
||||
-textureshared(-ts)
|
int
|
|||
|
||||
-topology(-tp)
|
int
|
|||
|
||||
-type(-t)
|
int
|
|||
|
||||
-uvBorderSelection(-ubs)
|
boolean
|
|||
|
||||
-uvConstraint(-uvc)
|
boolean
|
|||
|
||||
-uvEdgeLoopPropagation(-ulp)
|
boolean
|
|||
|
||||
-uvEdgeRingPropagation(-urp)
|
boolean
|
|||
|
||||
-uvFaceOrientation(-ufo)
|
int
|
|||
|
||||
-uvShell(-uv)
|
boolean
|
|||
|
||||
-visibility(-v)
|
int
|
|||
|
||||
-visibilityangle(-va)
|
angle
|
|||
|
||||
-visibilitypoint(-vp)
|
float float float
|
|||
|
||||
-where(-w)
|
int
|
|||
|
||||
-wholeSensitive(-ws)
|
boolean
|
|||
|
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. |
selectMode -co; // <b>Propagation</b> polyPlane -n plg -w 5 -h 5; delete plg.f[20:29]; selectType -pf true; polySelectConstraint -sh true; // next mouse selections will propagate to all shell polySelectConstraint -sh false; polySelectConstraint -bo true; // next mouse selections will propagate along border polySelectConstraint -bo false; polySelectConstraint -cr true; // next mouse selections will propagate to all connected creased components polySelectConstraint -cr false; select plg.f[54:55]; polySelectConstraint -pp 1; polySelectConstraint -pp 1; polySelectConstraint -pp 1; // to get more and more polySelectConstraint -pp 2; // to get less polySelectConstraint -pp 3; // to get selection border delete plg; //<b>Propagation along loop </b> polyPlane -n plg -w 5 -h 5; select plg.f[42:43] plg.f[53] plg.f[76]; polySelectConstraint -pp 5; //grow face selection along loop polySelectConstraint -pp 6; //shrink face selection along loop delete plg; polyPlane -n plg -w 5 -h 5; select plg.e[113] plg.e[115:116]; polySelectConstraint -pp 5; //grow edge selection along loop polySelectConstraint -pp 6; //shrink edge selection along loop delete plg; polyPlane -n plg -w 5 -h 5; select plg.vtx[59:61]; polySelectConstraint -pp 5; //grow vertex selection along loop polySelectConstraint -pp 6; //shrink vertex selection along loop delete plg; polyPlane -n plg -w 5 -h 5; select plg.map[71] plg.map[59:60]; polySelectConstraint -pp 5; // grow UV selection along loop polySelectConstraint -pp 6; // shrink UV selection along loop delete plg; //<b>Properties</b> //location polyPlane -n plg -w 5 -h 5; selectType -pv true; polySelectConstraint -m 3 -t 1 -w 1; // to get border vertices polySelectConstraint -m 3 -t 1 -w 2; // to get inner vertices polySelectConstraint -w 0; // turn off location constraint delete plg; //edge smoothness polyCylinder -n plg; selectType -pe true; polySelectConstraint -m 3 -t 0x8000 -sm 1; // to get hard edges polySelectConstraint -m 3 -t 0x8000 -sm 2; // to get soft edges polySelectConstraint -sm 0; // turn off edge smoothness constraint delete plg; //face size polyCylinder -n plg -sz 1; delete plg.f[40:59]; polyCloseBorder plg.e[27]; selectType -pf true; polySelectConstraint -m 3 -t 8 -sz 1; // to get triangles polySelectConstraint -m 3 -t 8 -sz 2; // to get quads polySelectConstraint -m 3 -t 8 -sz 3; // to get N-sided polySelectConstraint -sz 0; // turn off face size constraint delete plg; //face planarity // polyPlane -n plg -w 5 -h 5; polyMoveVertex -ltz 1 plg.vtx[79] plg.vtx[85]; selectType -pf true; polySelectConstraint -m 3 -t 8 -p 1; // to get non-planar faces polySelectConstraint -m 3 -t 8 -p 2; // to get planar faces polySelectConstraint -p 0; // turn off face planarity constraint delete plg; //face convexity polyPlane -n plg -w 5 -h 5; delete plg.f[51] plg.f[61] plg.f[52:53]; polyCloseBorder plg.e[146]; selectType -pf true; polySelectConstraint -m 3 -t 8 -c 1; // to get non-convex faces polySelectConstraint -m 3 -t 8 -c 2; // to get convex faces polySelectConstraint -c 0; // turn off face convexity constraint delete plg; //face holes polyCreateFacet -n plg -p -2 2 0 -p -2 -2 0 -p 2 -2 0 -p 2 2 0 ; polyAppend -ed 2 -p 6 -2 0 -p 6 2 0 -hl -p 3 1 0 -p 3 -1 0 -p 5 0 0 ; selectType -pf true; polySelectConstraint -m 3 -t 8 -h 1; // to get holed faces polySelectConstraint -m 3 -t 8 -h 2; // to get non-holed faces polySelectConstraint -h 0; // turn off hole constraint delete plg; //face mapping polyPlane -n plg -w 5 -h 5; polyMapDel plg.f[60:69]; selectType -pf true; polySelectConstraint -m 3 -t 8 -tx 1; // to get mapped faces polySelectConstraint -m 3 -t 8 -tx 2; // to get non-mapped faces polySelectConstraint -tx 0; // turn off face mapping constraint delete plg; //face topology polyCreateFacet -n plg -p -3 3 0 -p -3 -3 0 -p 3 -3 0 -p 3 3 0 ; polyAppend -ed 2 -p 8 -3 0 -p 8 3 0 ; polyAppend -ed 4 -ed 6 -ed 5; polyAppend -ed 0 -p -7 2 0 -p -7 -1 0 -p -8 2 0 -p -5 4 0 ; selectType -pf true; polySelectConstraint -m 3 -t 8 -tp 1; // to get non triangulatable faces polySelectConstraint -m 3 -t 8 -tp 2; // to get lamina faces polySelectConstraint -tp 0; // turn off the face topology constraint delete plg; //<b>Length</b> polyCylinder -n plg -sz 1 -h 3; selectType -pe true; polySelectConstraint -m 3 -t 0x8000 -l on -lb 2 4; // to get edges of length 2 to 4 units polySelectConstraint -m 3 -t 0x8000 -l on -lb 1 2; // to get edges of length 1 to 2 units polySelectConstraint -l off; // turn off the length constraint delete plg; //<b>Angle</b> polyCube -n plg -w 5 -h 5 -d 5; polyBevel -sg 1 plg.e[7]; polyBevel -sg 3 plg.e[9]; selectType -pe true; float $minAngle = 0.0; float $maxAngle = 89.0; if ("radian" == `currentUnit -q -angle -fullName`) { $maxAngle = `deg_to_rad $maxAngle`; } polySelectConstraint -m 3 -t 0x8000 -a on -ab $minAngle $maxnAngle; // to get edges with angle between 0-89 $minAngle = 45.0; $maxAngle = 89.0; if ("radian" == `currentUnit -q -angle -fullName`) { $minAngle = `deg_to_rad $minAngle`; $maxAngle = `deg_to_rad $maxAngle`; } polySelectConstraint -m 3 -t 0x8000 -a on -ab $minAngle $maxnAngle;// to get edges with angle between 45-89 polySelectConstraint -a off; // turn off angle constraint delete plg; //<b>3D Area</b> polyPlane -n plg -w 5 -h 5; polyMoveFacet -ls .5 .5 0 plg.f[70:79]; selectType -pf true; polySelectConstraint -m 3 -t 8 -ga on -gab 0 0.2; // to get faces with area between 0 and 0.2 polySelectConstraint -m 3 -t 8 -ga on -gab 0.2 0.3; // to get faces with area between 0 and 0.2 polySelectConstraint -ga off; // turn off 3D area constraint delete plg; //<b>2D area</b> polyCylinder -n plg; selectType -pf true; polySelectConstraint -m 3 -t 8 -ta on -tab 0 0.5; // to get face with texture area between 0-0.5 polySelectConstraint -ta off; // turn off the 2D area constraint delete plg; //<b>Distance</b> polyPlane -n plg -w 5 -h 5; selectType -pv true; polySelectConstraint -m 3 -t 1 -d 1 -db 0 5 -dp 5 0 0; // to get vertices located // between 0-5 units from a given point polySelectConstraint -m 3 -t 1 -d 1 -db 5 5 -dp 5 0 0 ; // to get vertices located // at exactly 5 units from a given point polySelectConstraint -m 3 -t 1 -d 2 -db 5 6 -dp 5 0 0 ; // to get vertices located // between 5-6 units from a given axis polySelectConstraint -d 0; // turn off the distance constraint delete plg; //<b>Orientation</b> polySphere -n plg; selectType -pv true; float $minAngle = 0.0; float $maxAngle = 30.0; if ("radian" == `currentUnit -q -angle -fullName`) { $maxAngle = `deg_to_rad $maxAngle`; } // to get vertices oriented between 0-30 degree to a given axis polySelectConstraint -m 3 -t 1 -o 1 -ob $minAngle $maxnAngle -oa 0 1 0; polySelectConstraint -m 3 -t 1 -o 2 -ob $minAngle $maxnAngle -oa 0 1 0; polySelectConstraint -o 0; // turn off the orintation constraint delete plg; //<b>Order (Neighbor)</b> polyPlane -n plg -w 5 -h 5; selectType -pv true; polySelectConstraint -m 3 -t 1 -or on -orb 0 2; // to get vertices with 0 to 2 neighbors polySelectConstraint -or off; // turn off the order (neighbor) constraint delete plg; //<b>Visibility</b> polySphere -n plg; selectType -pv true; polySelectConstraint -m 3 -t 1 -v on -va 60 -vp 10 0 0 ; // to get vertices in the 60 degree angle // from a given point polySelectConstraint -v off; // turn off the visbility constraint delete plg; //<b>Random</b> polyPlane -n plg -w 5 -h 5; selectType -pv true; polySelectConstraint -m 3 -t 1 -r on -rr .5; polySelectConstraint -r off; // turn off the random constraint delete plg; // NOTE: Make sure you turn off the constraint you have used. Otherwise it may // affect your next selection (if <i>mode</i> flag is ON).