Show frames
Go to: Synopsis. Return value. Related.
Flags. Python
examples.
filterExpand([expand=boolean], [fullPath=boolean], [selectionMask=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
filterExpand is undoable, NOT queryable, and NOT
editable.
Based on selected components (or components specified on the
command line), the command filters and/or expands the list given
the options. Returns a string array containing all matching
selection items. Selection masks are as follows:
Object Type |
Mask |
Handle |
0 |
Nurbs Curves |
9 |
Nurbs Surfaces |
10 |
Nurbs Curves On Surface |
11 |
Polygon |
12 |
Locator XYZ |
22 |
Orientation Locator |
23 |
Locator UV |
24 |
Control Vertices (CVs) |
28 |
Edit Points |
30 |
Polygon Vertices |
31 |
Polygon Edges |
32 |
Polygon Face |
34 |
Polygon UVs |
35 |
Subdivision Mesh Points |
36 |
Subdivision Mesh Edges |
37 |
Subdivision Mesh Faces |
38 |
Curve Parameter Points |
39 |
Curve Knot |
40 |
Surface Parameter Points |
41 |
Surface Knot |
42 |
Surface Range |
43 |
Trim Surface Edge |
44 |
Surface Isoparms |
45 |
Lattice Points |
46 |
Particles |
47 |
Scale Pivots |
49 |
Rotate Pivots |
50 |
Select Handles |
51 |
Subdivision Surface |
68 |
Polygon Vertex Face |
70 |
NURBS Surface Face |
72 |
Subdivision Mesh UVs |
73 |
selectType
expand, fullPath, selectionMask
Long name (short name) |
Argument types |
Properties |
selectionMask(sm) |
int |
  |
|
Specify the selection mask |
|
expand(ex) |
boolean |
 |
|
Each item is a single entity if this is true. Default is
true. |
|
fullPath(fp) |
boolean |
 |
|
If this is true and the selection item is a DAG object, return
its full selection path, instead of the name of the object only
when this value is false. Default is false. |
|
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. |
import maya.cmds as cmds
# Returns any selected isoparms (mask 45) as individual items
# (because of "ex=True").
cmds.filterExpand( ex=True, sm=45 )
# Returns any selected CVs (mask 28) as compact items. For example,
# if curve.cv[0:3] is selected, then "curve.cv[0:3]" is returned.
# If "ex=True", then four items are returned, one for each CV.
cmds.filterExpand( ex=False, sm=28 )
# Returns any selected CVs (mask 28) and edit points (mask 30).
cmds.filterExpand( sm=(28,30) )
# Returns any selected nurbs curves.
cmds.filterExpand( sm=9 )
# Returns any selected nurbs curves-on-surface.
cmds.filterExpand( sm=11 )
# return the poly faces (mask 34) from the specified arguments
cmds.filterExpand(["pCube1.f[1]","pCube1.f[4]","pCube1.vtx[0:3]"], sm=34)