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.

The selectType command is used to change the set of allowable types of objects that can be selected when using the select tool. It accepts no other arguments besides the flags.

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

booleanif a query operation

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

Related

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

In query mode, this flag needs a value.

rigidBody(rb) boolean createquery
Set rigid body selection mask on/off. (object flag)
rigidConstraint(rc) boolean createquery
Set rigid constraint selection mask on/off. (object flag)
rotatePivot(rp) boolean createquery
Set rotate pivot selection mask on/off. (component flag)
scalePivot(sp) boolean createquery
Set scale pivot selection mask on/off. (component flag)
sculpt(sc) boolean createquery
Set sculpt selection mask on/off. (object flag)
selectHandle(sh) boolean createquery
Set select handle selection mask on/off. (component flag)
spring(spr) boolean createquery
Set spring shape selection mask on/off. (object flag)
springComponent(spc) boolean createquery
Set individual spring selection mask on/off. (component flag)
stroke(str) boolean createquery
Set the Paint Effects stroke selection mask on/off. (object flag)
subdiv(sd) boolean createquery
Set subdivision surfaces selection mask on/off. (object flag)
subdivMeshEdge(sme) boolean createquery
Set subdivision surfaces mesh edge selection mask on/off. (component flag)
subdivMeshFace(smf) boolean createquery
Set subdivision surfaces mesh face selection mask on/off. (component flag)
subdivMeshPoint(smp) boolean createquery
Set subdivision surfaces mesh point selection mask on/off. (component flag)
subdivMeshUV(smu) boolean createquery
Set subdivision surfaces mesh UV map selection mask on/off. (component flag)
surfaceEdge(se) boolean createquery
Set surface edge selection mask on/off. (component flag)
surfaceFace(sf) boolean createquery
Set surface face selection mask on/off. (component flag)
surfaceKnot(sk) boolean createquery
Set surface knot selection mask on/off. (component flag)
surfaceParameterPoint(spp) boolean createquery
Set surface parameter point selection mask on/off. (component flag)
surfaceRange(sr) boolean createquery
Set surface range selection mask on/off. (component flag)
surfaceUV(suv) boolean createquery
Set surface uv selection mask on/off. (component flag)
texture(tx) boolean createquery
Set texture selection mask on/off. (object flag)
vertex(v) boolean createquery
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 )