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


artAttrTool([add=string], [exists=string], [remove=string])

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

artAttrTool is NOT undoable, queryable, and NOT editable.

The artAttrTool command manages the list of tool types which are used for attribute painting. This command supports querying the list contents as well as adding new tools to the list. Note that there is a set of built-in tools. The list of built-ins can be queried by starting Maya and doing an "artAttrTool -q".

The tools which are managed by this command are all intended for attribute painting via Artisan: when you create a new context via artAttrCtx you specify the tool name via artAttrCtx's -whichTool flag. Typically the user may wish to simply use one of the built-in tools. However, if you need to have custom Properties and Values sheets asscociated with your tool, you will need to define a custom tool via artAttrTool -add "toolName". For an example of a custom attribute painting tool, see the devkit example customtoolPaint.mel.

Return value


In query mode, return type is based on queried flag.


artisan, attribute, paint, context




add, exists, remove
Long name (short name) Argument types Properties
add() string create
Adds the named tool to the internal list of tools.
exists(ex) string createquery
Checks if the named tool exists, returning true if found, and false otherwise.
remove(rm) string create
Removes the named tool from the internal list of tools.

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

# Add a tool named "customtoolPaint" to the list of
# attribute painting tools, then creates a new context called
# "customtoolPaintContext" which utilises the "customtoolPaint" tool.
cmds.artAttrTool( add='customtoolPaint' )
cmds.artAttrCtx( 'customtoolPaintContext', whichTool='customtoolPaint' )
# List all tools currently defined.
cmds.artAttrTool( query=True )