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 |
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.
|
|
list(l)
|
boolean
|
|
|
List all available message types and their current enabled status.
|
|
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).
|
|
|
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