selectType

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

Synopsis

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

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

selectType is undoable, queryable, and NOT editable.

There are basically two different types of items that are selectable when interactively selecting objects in the 3D views. They are classified as objects (entire objects) or components (parts of objects). The object and component command flags control which class of objects are selectable.

It is possible to select components while in the object selection mode. To set the components which are selectable in object selection mode you must use the -ocm flag when specifying the component flags.

Return value

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

Related

Flags

Long name (short name)	Argument types	Properties
allComponents(alc)	boolean
Set all component selection masks on/off
allObjects(alo)	boolean
Set all object selection masks on/off
animBreakdown(abd)	boolean
Set animation breakdown selection mask on/off.
animCurve(ac)	boolean
Set animation curve selection mask on/off.
animInTangent(ait)	boolean
Set animation in-tangent selection mask on/off.
animKeyframe(ak)	boolean
Set animation keyframe selection mask on/off.
animOutTangent(aot)	boolean
Set animation out-tangent selection mask on/off.
byName(bn)	[string, boolean]
Set the specified user-defined selection mask on/off. (object flag)
camera(ca)	boolean
Set camera selection mask on/off. (object flag)
cluster(cl)	boolean
Set cluster selection mask on/off. (object flag)
collisionModel(clm)	boolean
Set collision model selection mask on/off. (object flag)
controlVertex(cv)	boolean
Set control vertex selection mask on/off. (component flag)
curve(c)	boolean
Set curve selection mask on/off. (object flag)
curveKnot(ck)	boolean
Set curve knot selection mask on/off. (component flag)
curveOnSurface(cos)	boolean
Set curve-on-surface selection mask on/off. (object flag)
curveParameterPoint(cpp)	boolean
Set curve parameter point selection mask on/off. (component flag)
dimension(dim)	boolean
Set dimension shape selection mask on/off. (object flag)
dynamicConstraint(dc)	boolean
Set dynamicConstraint selection mask on/off. (object flag)
edge(eg)	boolean
Set mesh edge selection mask on/off. (component flag)
editPoint(ep)	boolean
Set edit-point selection mask on/off. (component flag)
emitter(em)	boolean
Set emitter selection mask on/off. (object flag)
facet(fc)	boolean
Set mesh face selection mask on/off. (component flag)
field(fi)	boolean
Set field selection mask on/off. (object flag)
fluid(fl)	boolean
Set fluid selection mask on/off. (object flag)
follicle(fo)	boolean
Set follicle selection mask on/off. (object flag)
hairSystem(hs)	boolean
Set hairSystem selection mask on/off. (object flag)
handle(ha)	boolean
Set object handle selection mask on/off. (object flag)
hull(hl)	boolean
Set hull selection mask on/off. (component flag)
ikEndEffector(iee)	boolean
Set ik end effector selection mask on/off. (object flag)
ikHandle(ikh)	boolean
Set ik handle selection mask on/off. (object flag)
imagePlane(ip)	boolean
Set image plane selection mask on/off. (component flag)
implicitGeometry(ig)	boolean
Set implicit geometry selection mask on/off. (object flag)
isoparm(iso)	boolean
Set surface iso-parm selection mask on/off. (component flag)
joint(j)	boolean
Set ik handle selection mask on/off. (object flag)
jointPivot(jp)	boolean
Set joint pivot selection mask on/off. (component flag)
lattice(la)	boolean
Set lattice selection mask on/off. (object flag)
latticePoint(lp)	boolean
Set lattice point selection mask on/off. (component flag)
light(lt)	boolean
Set light selection mask on/off. (object flag)
localRotationAxis(ra)	boolean
Set local rotation axis selection mask on/off. (component flag)
locator(lc)	boolean
Set locator (all types) selection mask on/off. (object flag)
locatorUV(luv)	boolean
Set uv locator selection mask on/off. (object flag)
locatorXYZ(xyz)	boolean
Set xyz locator selection mask on/off. (object flag)
meshUVShell(msh)	boolean
Set uv shell component mask on/off.
motionTrailPoint(mtp)	boolean
Set motion point selection mask on/off.
motionTrailTangent(mtt)	boolean
Set motion point tangent mask on/off.
nCloth(ncl)	boolean
Set nCloth selection mask on/off. (object flag)
nParticle(npr)	boolean
Set nParticle point selection mask on/off. (component flag)
nParticleShape(nps)	boolean
Set nParticle shape selection mask on/off. (object flag)
nRigid(nr)	boolean
Set nRigid selection mask on/off. (object flag)
nonlinear(nl)	boolean
Set nonlinear selection mask on/off. (object flag)
nurbsCurve(nc)	boolean
Set nurbs-curve selection mask on/off. (object flag)
nurbsSurface(ns)	boolean
Set nurbs-surface selection mask on/off. (object flag)
objectComponent(ocm)	boolean
Component flags apply to object mode.
orientationLocator(ol)	boolean
Set orientation locator selection mask on/off. (object flag)
particle(pr)	boolean
Set particle point selection mask on/off. (component flag)
particleShape(ps)	boolean
Set particle shape selection mask on/off. (object flag)
plane(pl)	boolean
Set sketch plane selection mask on/off. (object flag)
polymesh(p)	boolean
Set poly-mesh selection mask on/off. (object flag)
polymeshEdge(pe)	boolean
Set poly-mesh edge selection mask on/off. (component flag)
polymeshFace(pf)	boolean
Set poly-mesh face selection mask on/off. (component flag)
polymeshFreeEdge(pfe)	boolean
Set poly-mesh free-edge selection mask on/off. (component flag)
polymeshUV(puv)	boolean
Set poly-mesh UV point selection mask on/off. (component flag)
polymeshVertex(pv)	boolean
Set poly-mesh vertex selection mask on/off. (component flag)
polymeshVtxFace(pvf)	boolean
Set poly-mesh vertexFace selection mask on/off. (component flag)
queryByName(qbn)	string
Query the specified user-defined selection mask. (object flag) In query mode, this flag needs a value.
rigidBody(rb)	boolean
Set rigid body selection mask on/off. (object flag)
rigidConstraint(rc)	boolean
Set rigid constraint selection mask on/off. (object flag)
rotatePivot(rp)	boolean
Set rotate pivot selection mask on/off. (component flag)
scalePivot(sp)	boolean
Set scale pivot selection mask on/off. (component flag)
sculpt(sc)	boolean
Set sculpt selection mask on/off. (object flag)
selectHandle(sh)	boolean
Set select handle selection mask on/off. (component flag)
spring(spr)	boolean
Set spring shape selection mask on/off. (object flag)
springComponent(spc)	boolean
Set individual spring selection mask on/off. (component flag)
stroke(str)	boolean
Set the Paint Effects stroke selection mask on/off. (object flag)
subdiv(sd)	boolean
Set subdivision surfaces selection mask on/off. (object flag)
subdivMeshEdge(sme)	boolean
Set subdivision surfaces mesh edge selection mask on/off. (component flag)
subdivMeshFace(smf)	boolean
Set subdivision surfaces mesh face selection mask on/off. (component flag)
subdivMeshPoint(smp)	boolean
Set subdivision surfaces mesh point selection mask on/off. (component flag)
subdivMeshUV(smu)	boolean
Set subdivision surfaces mesh UV map selection mask on/off. (component flag)
surfaceEdge(se)	boolean
Set surface edge selection mask on/off. (component flag)
surfaceFace(sf)	boolean
Set surface face selection mask on/off. (component flag)
surfaceKnot(sk)	boolean
Set surface knot selection mask on/off. (component flag)
surfaceParameterPoint(spp)	boolean
Set surface parameter point selection mask on/off. (component flag)
surfaceRange(sr)	boolean
Set surface range selection mask on/off. (component flag)
surfaceUV(suv)	boolean
Set surface uv selection mask on/off. (component flag)
texture(tx)	boolean
Set texture selection mask on/off. (object flag)
vertex(v)	boolean
Set mesh vertex selection mask on/off. (component flag)

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.selectType( allObjects=True )
cmds.selectType( q=True, cv=True )
cmds.selectType( allObjects=True, allComponents=False )