In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-allConnections(-ac)
|
|
|
|
If specified, the traversal that searches for the history or future will
not restrict its traversal across nodes to only dependent plugs.
Thus it will reach all upstream nodes (or all downstream nodes for f/future).
|
|
-allFuture(-af)
|
|
|
|
If listing the future, list all of it. Otherwise if a shape has
an attribute that represents its output geometry data, and that plug
is connected, only list the future history downstream from that
connection.
|
|
-allGraphs(-ag)
|
boolean
|
|
|
This flag is obsolete and has no effect.
|
|
-breadthFirst(-bf)
|
|
|
|
The breadth first traversal will return the closest nodes in the
traversal first. The depth first traversal will follow a complete
path away from the node, then return to any other paths from the
node. Default is depth first.
|
|
-fastIteration(-fi)
|
boolean
|
|
|
This flag enables a faster iteration mode that offers more scalable performance,
especially when traversing nodes with numerous connections. However, the results can
be slightly different, especially in cases with transitive dependencies between
attributes (attribute A is affected by B which is affected by C, but A is not
directly affected by C).
|
|
-fullNodeName(-fnn) 2023.1
|
boolean
|
|
|
Return full node name in result.
|
|
-future(-f)
|
boolean
|
|
|
List the future instead of the history.
|
|
-futureLocalAttr(-fl)
|
|
|
|
This flag allows querying of the local-space future-related attribute(s) on shape nodes.
|
|
-futureWorldAttr(-fw)
|
|
|
|
This flag allows querying of the world-space future-related attribute(s) on shape nodes.
|
|
-groupLevels(-gl)
|
boolean
|
|
|
The node names are grouped depending on the level. > 1 is
the lead, the rest are grouped with it.
|
|
-historyAttr(-ha)
|
|
|
|
This flag allows querying of the attribute where history connects on shape nodes.
|
|
-interestLevel(-il)
|
int
|
|
|
If this flag is set, only nodes whose historicallyInteresting
attribute value is not less than the value will be listed.
The historicallyInteresting attribute is 0 on nodes which are
not of interest to non-programmers. 1 for the TDs, 2 for the users.
|
|
-leaf(-lf)
|
boolean
|
|
|
If transform is selected, show history for its leaf
shape. Default is true.
|
|
-levels(-lv)
|
uint
|
|
|
Levels deep to traverse. Setting the number of levels to
0 means do all levels. All levels is the default.
|
|
-pruneDagObjects(-pdo)
|
boolean
|
|
|
If this flag is set, prune at dag objects.
|
|