pymel.core.general.selectPriority¶

selectPriority(*args, **kwargs)¶

The selectPrioritycommand is used to change the selection priority of particular types of objects that can be selected when using the select tool. It accepts no other arguments besides the flags. These flags are the same as used by the ‘selectType’ command.

Flags:

Long Name / Short Name		Argument Types	Properties
allComponents / alc		int
	Set all component selection priority
allObjects / alo		int
	Set all object selection priority
animBreakdown / abd		int
	Set animation breakdown selection priority
animCurve / ac		int
	Set animation curve selection priority
animInTangent / ait		int
	Set animation in-tangent selection priority
animKeyframe / ak		int
	Set animation keyframe selection priority
animOutTangent / aot		int
	Set animation out-tangent selection priority
byName / bn		unicode, bool
	Set selection priority for the specified user-defined selection type
camera / ca		int
	Set camera selection priority
cluster / cl		int
	Set cluster selection priority
collisionModel / clm		int
	Set collision model selection priority
controlVertex / cv		int
	Set control vertex selection priority
curve / c		int
	Set curve selection priority
curveKnot / ck		int
	Set curve knot selection priority
curveOnSurface / cos		int
	Set curve-on-surface selection priority
curveParameterPoint / cpp		int
	Set curve parameter point selection priority
dimension / dim		int
	Set dimension shape selection priority
dynamicConstraint / dc		int
	Set dynamicConstraint selection priority
edge / eg		int
	Set mesh edge selection priority
editPoint / ep		int
	Set edit-point selection priority
emitter / em		int
	Set emitter selection priority
facet / fc		int
	Set mesh face selection priority
field / fi		int
	Set field selection priority
fluid / fl		int
	Set fluid selection priority
follicle / fo		int
	Set follicle selection priority
hairSystem / hs		int
	Set hairSystem selection priority
handle / ha		int
	Set object handle selection priority
hull / hl		int
	Set hull selection priority
ikEndEffector / iee		int
	Set ik end effector selection priority
ikHandle / ikh		int
	Set ik handle selection priority
imagePlane / ip		int
	Set image plane selection mask priority
implicitGeometry / ig		int
	Set implicit geometry selection priority
isoparm / iso		int
	Set surface iso-parm selection priority
joint / j		int
	Set ik handle selection priority
jointPivot / jp		int
	Set joint pivot selection priority
lattice / la		int
	Set lattice selection priority
latticePoint / lp		int
	Set lattice point selection priority
light / lt		int
	Set light selection priority
localRotationAxis / ra		int
	Set local rotation axis selection priority
locator / lc		int
	Set locator (all types) selection priority
locatorUV / luv		int
	Set uv locator selection priority
locatorXYZ / xyz		int
	Set xyz locator selection priority
meshUVShell / msh		bool
	Set uv shell component mask on/off.
motionTrailPoint / mtp		int
	Set motion point selection priority
motionTrailTangent / mtt		int
	Set motion point tangent priority
nCloth / ncl		int
	Set nCloth selection priority
nParticle / npr		int
	Set nParticle point selection priority
nParticleShape / nps		int
	Set nParticle shape selection priority
nRigid / nr		int
	Set nRigid selection priority
nonlinear / nl		int
	Set nonlinear selection priority
nurbsCurve / nc		int
	Set nurbs-curve selection priority
nurbsSurface / ns		int
	Set nurbs-surface selection priority
orientationAxis / oa		int
orientationLocator / ol		int
	Set orientation locator selection priority
particle / pr		int
	Set particle point selection priority
particleShape / ps		int
	Set particle shape selection priority
plane / pl		int
	Set sketch plane selection priority
polymesh / p		int
	Set poly-mesh selection priority
polymeshEdge / pe		int
	Set poly-mesh edge selection priority
polymeshFace / pf		int
	Set poly-mesh face selection priority
polymeshFreeEdge / pfe		int
	Set poly-mesh free-edge selection priority
polymeshUV / puv		int
	Set poly-mesh UV point selection priority
polymeshVertex / pv		int
	Set poly-mesh vertex selection priority
polymeshVtxFace / pvf		int
	Set poly-mesh vtxFace selection priority
queryByName / qbn		unicode
	Query selection priority for the specified user-defined selection type
rigidBody / rb		int
	Set rigid body selection priority
rigidConstraint / rc		int
	Set rigid constraint selection priority
rootHandle / rh		int
rotatePivot / rp		int
	Set rotate pivot selection priority
scalePivot / sp		int
	Set scale pivot selection priority
sculpt / sc		int
	Set sculpt selection priority
selectHandle / sh		int
	Set select handle selection priority
sets / set		int
slugObject / slo		int
slugVertex / sv		int
softBody / sb		int
spotlightComponent / slc		int
spring / spr		int
	Set spring shape selection priority
springComponent / spc		int
	Set individual spring selection priority
stroke / str		int
	Set stroke selection priority
subdiv / sd		int
	Set subdivision surface selection priority
subdivMeshEdge / sme		int
	Set subdivision surface mesh edge selection priority
subdivMeshFace / smf		int
	Set subdivision surface mesh face selection priority
subdivMeshPoint / smp		int
	Set subdivision surface mesh point selection priority
subdivMeshUV / smu		int
	Set subdivision surface mesh UV map selection priority
subdivisionPolymesh / spl		int
subdivisionPolymeshEdge / spe		int
subdivisionPolymeshFace / spf		int
subdivisionPolymeshVertex / spv		int
surfaceEdge / se		int
	Set surface edge selection priority
surfaceFace / sf		int
	Set surface face selection priority
surfaceKnot / sk		int
	Set surface knot selection priority
surfaceParameterPoint / spp		int
	Set surface parameter point selection priority
surfaceRange / sr		int
	Set surface range selection priority
texture / tx		int
	Set texture selection priority
vertex / v		int
	Set mesh vertex selection priority Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.selectPriority

Example:

import pymel.core as pm

pm.selectPriority( q=True, nurbsCurve=True )
# Result: 2 #
pm.selectPriority( nurbsCurve=10 )
pm.selectPriority( handle=9, ikHandle=8 )