Go to: Synopsis. Return value. Keywords. Flags. MEL examples.
expandedSelection [-depth uint] [-expansionType string]
expandedSelection is NOT undoable, NOT queryable, and NOT editable.
Examines the current selection list and returns that list, expanded to meet certain
criteria. See the command flags for the exact criteria that will be used.
string | List of objects in the requested selection list expansion |
string[] | List of nodes visited in the DG expansion |
string[] | (Python only) List of single nodes and tuples visited in the EG or SG expansion, where tuples represent the DG nodes in a cluster |
select
depth, expansionType
Long name (short name) |
Argument types |
Properties |
-depth(-d)
|
uint
|
|
|
Number of steps away from current selection to expand to.
A value of 0 will not expand the selection at all.
|
|
-expansionType(-et)
|
string
|
|
|
The type of graph along which to expand the selection. Legal values are:
- DG : Use the normal DG connections
- EG : Use the evaluation graph connections
- SG : Use the scheduling graph connections within the evaluation graph
If the actual selected node is not included in the graph being expanded on, e.g.
there is no evaluation node when using the EG type, then the selected node will not
appear in the output.
If this flag is not specified then the type defaults to DG.
|
|
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.
|
createNode -n "t1" "transform";
createNode -n "t2" "transform";
connectAttr "t1.tx" "t2.tx";
select "t1";
// Get the list of all DG nodes at most one connection away from the selected one, including it
expandedSelection -depth 1 -expansionType "DG";
// Result: t1 t2 //