selectType

Go to: Synopsis. Return value. Related. Flags. MEL 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] [-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]

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)
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 be used more than once in a command.

MEL examples

selectType -allObjects true;
selectType -q -cv;
selectType -allObjects true -allComponents false;