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

Synopsis

artAttrTool [-add string] [-exists string] [-remove string]

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

None

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

Keywords

artisan, attribute, paint, context

Related

artAttrCtx

Flags

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 be used more than once in a command.

MEL examples


// Add a tool named "customtoolPaint" to the list of
// attribute painting tools, then creates a new context called
// "customtoolPaintContext" which utilises the "customtoolPaint" tool.
//
artAttrTool -add "customtoolPaint";
artAttrCtx -whichTool "customtoolPaint" "customtoolPaintContext";

// List all tools currently defined.
//
artAttrTool -q;