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


dbcount([enabled=boolean], [file=string], [keyword=string], [list=boolean], [maxdepth=uint], [quick=boolean], [reset=boolean], [spreadsheet=boolean])

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

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

The dbcount command is used to print and manage a list of statistics collected for counting operations. These statistics are displayed as a list of hits on a particular location in code, with added reference information for pointers/strings/whatever. If -reset is not specified then statistics are printed.

Return value



debug, count, filter


enabled, file, keyword, list, maxdepth, quick, reset, spreadsheet
Long name (short name) Argument types Properties
reset(r) boolean create
Reset all counters back to 0 and remove all but the top level counters. Returns the list of all counters affected.
enabled(e) boolean create
Set the enabled state of the counters ('on' to enable, 'off' to disable). Returns the list of all counters affected.
keyword(k) string create
Print only the counters whose name matches this keyword (default is all).
list(l) boolean create
List all available counters and their current enabled status. (The only thing you can do when counters are disabled.)
maxdepth(md) uint create
Maximum number of levels down to traverse and report. 0 is the default and it means continue recursing as many times as are requested.
file(f) string create
Destination file of the enabled count objects. 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.
quick(q) boolean create
Display only a summary for each counter type instead of the full details.
spreadsheet(s) boolean create
Display in spreadsheet format instead of the usual nested braces. This will include a header row that contains 'Count Level1 Level2 Level3...', making the data suitable for opening directly in a spreadsheet table.

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

cmds.dbcount( e='on' )              # Enable counters
cmds.dbcount( )                     # Print all available counters
cmds.dbcount( f='myCounts.txt' )    # Print all available counters to the file "myCounts.txt"
cmds.dbcount( k='dirty' )           # Print all counters with "dirty" in their name
cmds.dbcount( r=True, k='dirty' )   # Reset counters with "dirty" in their name
cmds.dbcount( l=True )              # List all counters
cmds.dbcount( l=True, k='dirty' )   # List all counters with "dirty" in their name
cmds.dbcount( s=True, f='xls.txt' ) # Print all counters in spreadsheet form to the file "xls.txt"