Go to: Synopsis. Return value. Related. Flags. MEL examples.
filterExpand [-expand boolean] [-fullPath boolean] [-selectionMask int]
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 be used more than once in a command.
|
// Returns any selected isoparms (mask 45) as individual items
// (because of "-ex true").
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.
filterExpand -ex false -sm 28;
// Returns any selected CVs (mask 28) and edit points (mask 30).
filterExpand -sm 28 -sm 30;
// Returns any selected nurbs curves.
filterExpand -sm 9;
// Returns any selected nurbs curves-on-surface.
filterExpand -sm 11;
// return the poly faces (mask 34) from the specified arguments
filterExpand -sm 34 "pCube1.f[1]" "pCube1.f[4]" "pCube1.vtx[0:3]";