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]";