OpenMaya.MFnDagNode

bnFind DAG node iterator.
bnGet Retrieve a single DAG node.
__str__ Full path name.
bnFindChildren DAG node iterator over the children.
bnGetChild Retrieve a single DAG node child.
classmethod MFnDagNode.bnFind(pattern=None, recursive=True, traverseUnderWorld=True)[source]

DAG node iterator.

The calling class defines the function set type for which the nodes need to be compatible with. It also represents the type of the object returned.

Categories: foundation.

Parameters:
  • pattern (str) – Path or full path pattern of the DAG nodes to match. Wildcards are allowed.
  • recursive (bool) – True to search recursively.
  • traverseUnderWorld (bool) – True to search within the underworld.
Yields:

maya.OpenMaya.MDagNode – The nodes found.

Note

The pattern matching’s global context is set to full path if the parameter traverseUnderWorld is True, and to path otherwise. See Matching Rules.

See also

Pattern Matching, Retrieving Nodes

classmethod MFnDagNode.bnGet(pattern=None, recursive=True, traverseUnderWorld=True)[source]

Retrieve a single DAG node.

The calling class defines the function set type for which the node needs to be compatible with. It also represents the type of the object returned.

Categories: foundation.

Parameters:
  • pattern (str) – Path or full path pattern of the DAG node to match. Wildcards are allowed.
  • recursive (bool) – True to search recursively.
  • traverseUnderWorld (bool) – True to search within the underworld.
Returns:

The DAG node found. If none or many were found, None is returned.
Return type:

maya.OpenMaya.MFnDagNode

Note

The pattern matching’s global context is set to full path if the parameter traverseUnderWorld is True, and to path otherwise. See Matching Rules.

See also

Pattern Matching, Retrieving Nodes

MFnDagNode.__str__()[source]

Full path name.

It is helpful when interacting with the commands layer by not having to manually call the fullPathName() method each time a MFnDagNode object needs to be passed to a command.

Categories: fix.

Returns:The full path name.
Return type:str
MFnDagNode.bnFindChildren(pattern=None, fnType=maya.OpenMaya.MFn.kInvalid, recursive=True, traverseUnderWorld=True)[source]

DAG node iterator over the children.

Categories: foundation.

Parameters:
  • pattern (str) – Path or full path pattern of the DAG nodes to match, relative to the current node. Wildcards are allowed.
  • fnType (maya.OpenMaya.MFn.Type) – Function set type to match.
  • recursive (bool) – True to search recursively.
  • traverseUnderWorld (bool) – True to search within the underworld.
Yields:

maya.OpenMaya.MDagNode – The nodes found.

Note

The pattern matching’s global context is set to full path if the parameter traverseUnderWorld is True, and to path otherwise. See Matching Rules.

See also

Pattern Matching, Retrieving Nodes

MFnDagNode.bnGetChild(pattern=None, fnType=maya.OpenMaya.MFn.kInvalid, recursive=True, traverseUnderWorld=True)[source]

Retrieve a single DAG node child.

Categories: foundation.

Parameters:
  • pattern (str) – Path or full path pattern of the DAG nodes to match, relative to the current node. Wildcards are allowed.
  • fnType (maya.OpenMaya.MFn.Type) – Function set type to match.
  • recursive (bool) – True to search recursively.
  • traverseUnderWorld (bool) – True to search within the underworld.
Returns:

The node found.
Return type:

maya.OpenMaya.MDagNode

Note

The pattern matching’s global context is set to full path if the parameter traverseUnderWorld is True, and to path otherwise. See Matching Rules.

See also

Pattern Matching, Retrieving Nodes