Go to: Synopsis. Return value. Keywords.
Flags. Python
examples.
dbmessage([file=string], [list=boolean], [monitor=boolean], [type=string])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
dbmessage is NOT undoable, NOT queryable, and
NOT editable.
The dbmessage command is used to install monitors for
certain message types, dumping debug information as they are sent
so that the flow of messages can be examined.
None
debug, message, filter
file, list,
monitor, type
Long name (short name) |
Argument types |
Properties |
monitor(m) |
boolean |
|
|
Set the monitoring state of the message type ('on' to enable,
'off' to disable). Returns the list of all message types being
monitored after the change in state. |
|
type(t) |
string |
|
|
Monitor only the messages whose name matches this keyword
(default is all). |
|
list(l) |
boolean |
|
|
List all available message types and their current enabled
status. |
|
file(f) |
string |
|
|
Destination file of the message monitoring information. Use the
special names stdout and stderr to redirect to your
command window. As well, the special name msdev is available
on NT to direct your output to the debug tab in the output window
of Developer Studio. Default value is stdout. |
|
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. |
import maya.cmds as cmds
cmds.dbmessage( m='on' ) # Enable monitoring of all messages
cmds.dbmessage( l=True ) # Print all available messages and monitoring state
cmds.dbmessage( f='msgs.txt' ) # Redirect all message output to the file "msgs.txt"
cmds.dbmessage( t='dgNodeAdded', m='on' ) # Turn on monitoring for the "dgNodeAdded" message