Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

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.

Return value

stringList 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

Keywords

select

Flags

depth, expansionType
Long name (short name) Argument types Properties
-depth(-d) uint create
Number of steps away from current selection to expand to. A value of 0 will not expand the selection at all.
-expansionType(-et) string create
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.

MEL examples


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 //