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

Synopsis

selectPriority([allComponents=uint], [allObjects=uint], [animBreakdown=uint], [animCurve=uint], [animInTangent=uint], [animKeyframe=uint], [animOutTangent=uint], [byName=[string, boolean]], [camera=uint], [cluster=uint], [collisionModel=uint], [controlVertex=uint], [curve=uint], [curveKnot=uint], [curveOnSurface=uint], [curveParameterPoint=uint], [dimension=uint], [dynamicConstraint=uint], [edge=uint], [editPoint=uint], [emitter=uint], [facet=uint], [field=uint], [fluid=uint], [follicle=uint], [hairSystem=uint], [handle=uint], [hull=uint], [ikEndEffector=uint], [ikHandle=uint], [imagePlane=uint], [implicitGeometry=uint], [isoparm=uint], [joint=uint], [jointPivot=uint], [lattice=uint], [latticePoint=uint], [light=uint], [localRotationAxis=uint], [locator=uint], [locatorUV=uint], [locatorXYZ=uint], [meshUVShell=boolean], [motionTrailPoint=uint], [motionTrailTangent=uint], [nCloth=uint], [nParticle=uint], [nParticleShape=uint], [nRigid=uint], [nonlinear=uint], [nurbsCurve=uint], [nurbsSurface=uint], [orientationLocator=uint], [particle=uint], [particleShape=uint], [plane=uint], [polymesh=uint], [polymeshEdge=uint], [polymeshFace=uint], [polymeshFreeEdge=uint], [polymeshUV=uint], [polymeshVertex=uint], [polymeshVtxFace=uint], [queryByName=string], [rigidBody=uint], [rigidConstraint=uint], [rotatePivot=uint], [scalePivot=uint], [sculpt=uint], [selectHandle=uint], [spring=uint], [springComponent=uint], [stroke=uint], [subdiv=uint], [subdivMeshEdge=uint], [subdivMeshFace=uint], [subdivMeshPoint=uint], [subdivMeshUV=uint], [surfaceEdge=uint], [surfaceFace=uint], [surfaceKnot=uint], [surfaceParameterPoint=uint], [surfaceRange=uint], [texture=uint], [vertex=uint])

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

selectPriority is undoable, queryable, and NOT editable.

The selectPriority command 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.

Return value

intif a query operation

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

Related

select, selectKey, selectMode, selectPref, selectType, selectedNodes

Flags

allComponents, allObjects, animBreakdown, animCurve, animInTangent, animKeyframe, animOutTangent, byName, camera, cluster, collisionModel, controlVertex, curve, curveKnot, curveOnSurface, curveParameterPoint, dimension, dynamicConstraint, edge, editPoint, emitter, facet, field, fluid, follicle, hairSystem, handle, hull, ikEndEffector, ikHandle, imagePlane, implicitGeometry, isoparm, joint, jointPivot, lattice, latticePoint, light, localRotationAxis, locator, locatorUV, locatorXYZ, meshUVShell, motionTrailPoint, motionTrailTangent, nCloth, nParticle, nParticleShape, nRigid, nonlinear, nurbsCurve, nurbsSurface, orientationLocator, particle, particleShape, plane, polymesh, polymeshEdge, polymeshFace, polymeshFreeEdge, polymeshUV, polymeshVertex, polymeshVtxFace, queryByName, rigidBody, rigidConstraint, rotatePivot, scalePivot, sculpt, selectHandle, spring, springComponent, stroke, subdiv, subdivMeshEdge, subdivMeshFace, subdivMeshPoint, subdivMeshUV, surfaceEdge, surfaceFace, surfaceKnot, surfaceParameterPoint, surfaceRange, texture, vertex
Long name (short name) Argument types Properties
allComponents(alc) uint createquery
Set all component selection priority
allObjects(alo) uint createquery
Set all object selection priority
animBreakdown(abd) uint createquery
Set animation breakdown selection priority
animCurve(ac) uint createquery
Set animation curve selection priority
animInTangent(ait) uint createquery
Set animation in-tangent selection priority
animKeyframe(ak) uint createquery
Set animation keyframe selection priority
animOutTangent(aot) uint createquery
Set animation out-tangent selection priority
byName(bn) [string, boolean] createmultiuse
Set selection priority for the specified user-defined selection type
camera(ca) uint createquery
Set camera selection priority
cluster(cl) uint createquery
Set cluster selection priority
collisionModel(clm) uint createquery
Set collision model selection priority
controlVertex(cv) uint createquery
Set control vertex selection priority
curve(c) uint createquery
Set curve selection priority
curveKnot(ck) uint createquery
Set curve knot selection priority
curveOnSurface(cos) uint createquery
Set curve-on-surface selection priority
curveParameterPoint(cpp) uint createquery
Set curve parameter point selection priority
dimension(dim) uint createquery
Set dimension shape selection priority
dynamicConstraint(dc) uint createquery
Set dynamicConstraint selection priority
edge(eg) uint createquery
Set mesh edge selection priority
editPoint(ep) uint createquery
Set edit-point selection priority
emitter(em) uint createquery
Set emitter selection priority
facet(fc) uint createquery
Set mesh face selection priority
field(fi) uint createquery
Set field selection priority
fluid(fl) uint createquery
Set fluid selection priority
follicle(fo) uint createquery
Set follicle selection priority
hairSystem(hs) uint createquery
Set hairSystem selection priority
handle(ha) uint createquery
Set object handle selection priority
hull(hl) uint createquery
Set hull selection priority
ikEndEffector(iee) uint createquery
Set ik end effector selection priority
ikHandle(ikh) uint createquery
Set ik handle selection priority
imagePlane(ip) uint createquery
Set image plane selection mask priority
implicitGeometry(ig) uint createquery
Set implicit geometry selection priority
isoparm(iso) uint createquery
Set surface iso-parm selection priority
joint(j) uint createquery
Set ik handle selection priority
jointPivot(jp) uint createquery
Set joint pivot selection priority
lattice(la) uint createquery
Set lattice selection priority
latticePoint(lp) uint createquery
Set lattice point selection priority
light(lt) uint createquery
Set light selection priority
localRotationAxis(ra) uint createquery
Set local rotation axis selection priority
locator(lc) uint createquery
Set locator (all types) selection priority
locatorUV(luv) uint createquery
Set uv locator selection priority
locatorXYZ(xyz) uint createquery
Set xyz locator selection priority
meshUVShell(msh) boolean createquery
Set uv shell component mask on/off.
motionTrailPoint(mtp) uint createquery
Set motion point selection priority
motionTrailTangent(mtt) uint createquery
Set motion point tangent priority
nCloth(ncl) uint createquery
Set nCloth selection priority
nParticle(npr) uint createquery
Set nParticle point selection priority
nParticleShape(nps) uint createquery
Set nParticle shape selection priority
nRigid(nr) uint createquery
Set nRigid selection priority
nonlinear(nl) uint createquery
Set nonlinear selection priority
nurbsCurve(nc) uint createquery
Set nurbs-curve selection priority
nurbsSurface(ns) uint createquery
Set nurbs-surface selection priority
orientationLocator(ol) uint createquery
Set orientation locator selection priority
particle(pr) uint createquery
Set particle point selection priority
particleShape(ps) uint createquery
Set particle shape selection priority
plane(pl) uint createquery
Set sketch plane selection priority
polymesh(p) uint createquery
Set poly-mesh selection priority
polymeshEdge(pe) uint createquery
Set poly-mesh edge selection priority
polymeshFace(pf) uint createquery
Set poly-mesh face selection priority
polymeshFreeEdge(pfe) uint createquery
Set poly-mesh free-edge selection priority
polymeshUV(puv) uint createquery
Set poly-mesh UV point selection priority
polymeshVertex(pv) uint createquery
Set poly-mesh vertex selection priority
polymeshVtxFace(pvf) uint createquery
Set poly-mesh vtxFace selection priority
queryByName(qbn) string query
Query selection priority for the specified user-defined selection type

In query mode, this flag needs a value.

rigidBody(rb) uint createquery
Set rigid body selection priority
rigidConstraint(rc) uint createquery
Set rigid constraint selection priority
rotatePivot(rp) uint createquery
Set rotate pivot selection priority
scalePivot(sp) uint createquery
Set scale pivot selection priority
sculpt(sc) uint createquery
Set sculpt selection priority
selectHandle(sh) uint createquery
Set select handle selection priority
spring(spr) uint createquery
Set spring shape selection priority
springComponent(spc) uint createquery
Set individual spring selection priority
stroke(str) uint createquery
Set stroke selection priority
subdiv(sd) uint createquery
Set subdivision surface selection priority
subdivMeshEdge(sme) uint createquery
Set subdivision surface mesh edge selection priority
subdivMeshFace(smf) uint createquery
Set subdivision surface mesh face selection priority
subdivMeshPoint(smp) uint createquery
Set subdivision surface mesh point selection priority
subdivMeshUV(smu) uint createquery
Set subdivision surface mesh UV map selection priority
surfaceEdge(se) uint createquery
Set surface edge selection priority
surfaceFace(sf) uint createquery
Set surface face selection priority
surfaceKnot(sk) uint createquery
Set surface knot selection priority
surfaceParameterPoint(spp) uint createquery
Set surface parameter point selection priority
surfaceRange(sr) uint createquery
Set surface range selection priority
texture(tx) uint createquery
Set texture selection priority
vertex(v) uint createquery
Set mesh vertex selection priority

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

cmds.selectPriority( q=True, nurbsCurve=True )
cmds.selectPriority( nurbsCurve=10 )
cmds.selectPriority( handle=9, ikHandle=8 )