pymel.core.general.listHistory

listHistory(*args, **kwargs)

This command traverses backwards or forwards in the graph from the specified node and returns all of the nodes whose construction history it passes through. The construction history consists of connections to specific attributes of a node defined as the creators and results of the node’s main data, eg. the curve for a Nurbs Curve node. For information on history connections through specific plugs use the listConnectionscommand first to find where the history begins then use this command on the resulting node.

Modifications:

• returns an empty list when the result is None

• added a much needed ‘type’ filter

• added an ‘exactType’ filter (if both ‘exactType’ and ‘type’ are present, ‘type’ is ignored)

  rtype:DependNode list

Flags:

• allFuture : af (bool) [create]

  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 (bool) [create]

  By default, the traversal will remain in the current graph. If this flag is set to true, the traversal will descend into subgraphs, and ascend into parent graphs.

• breadthFirst : bf (bool) [create]

  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.

• future : f (bool) [create]

  List the future instead of the history.

• futureLocalAttr : fl (bool) [query]

  This flag allows querying of the local-space future-related attribute(s) on shape nodes. Flag can have multiple arguments, passed either as a tuple or a list.

• futureWorldAttr : fw (bool) [query]

  This flag allows querying of the world-space future-related attribute(s) on shape nodes.

• groupLevels : gl (bool) [create]

  The node names are grouped depending on the level. 1 is the lead, the rest are grouped with it.

• historyAttr : ha (bool) [query]

  This flag allows querying of the attribute where history connects on shape nodes.

• interestLevel : il (int) [create]

  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 (bool) [create]

  If transform is selected, show history for its leaf shape. Default is true.

• levels : lv (int) [create]

  Levels deep to traverse. Setting the number of levels to 0 means do all levels. All levels is the default.

• pruneDagObjects : pdo (bool) [create]

  If this flag is set, prune at dag objects.

Derived from mel command maya.cmds.listHistory