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


dagObjectCompare([attribute=boolean], [bail=string], [connection=boolean], [namespace=string], [relative=boolean], [short=boolean], [type=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

dagObjectCompare is NOT undoable, NOT queryable, and NOT editable.

dagObjectCompare can be used to compare to compare objects based on:

Return value



dag, compare


attribute, bail, connection, namespace, relative, short, type
Long name (short name) Argument types Properties
type(t) boolean create
Compare based on dag object type
attribute(a) boolean create
Compare dag object attributes
connection(c) boolean create
Compare dag connections
relative(r) boolean create
dag relatives
namespace(n) string create
The baseline namespace
bail(b) string create
Bail on first error or bail on category. Legal values are "never", "first", and "category".
short(s) boolean create
Compress output to short form (not as verbose)

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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Compare two objects based on type and their relatives where one is in the namespace "base":
cmds.dagObjectCompare( t=True, r=True, n="base" )
# Compare two objects based on their connections and attributes where one is in the namespace "base" , break on first error:
cmds.dagObjectCompare( c=True, a=True, b="first")
# Compare two objects based on their type, connections, attributes, relatives and break on error while finishing current category:
cmds.dagObjectCompare( t=True, r=True, c=True, a=True, b=True, category=True, n="base")