Go to: Synopsis. Flags. Return value. Keywords. Related. Python examples.
makePaintable([activate=boolean], [activateAll=boolean], [altAttribute=string], [attrType=string], [clearAll=boolean], [remove=boolean], [shapeMode=string], [uiName=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
makePaintable is undoable, queryable, and NOT editable.
Make attributes of nodes paintable to Attribute Paint Tool.
This command is used to register new attributes to the
Attribute Paint tool as paintable. Once registered the
attributes will be recognized by the Attribute Paint tool
and the user will be able to paint them.
activate, activateAll, altAttribute, attrType, clearAll, remove, shapeMode, uiName
| Long name (short name) |
[argument types] |
Properties |
shapeMode(sm)
|
string
|
 
|
|
This flag controls how Artisan correlates the paintable node to a
corresponding shape node. It is used for attributes of type multi
of multi, where the first multi dimension corresponds to the shape
index (i.e. cluster nodes). At present, only one value of this flag
is supported: "deformer". By default this flag is an empty string,
which means that there is a direct indexing (no special mapping
required) of the attribute with respect to vertices on the shape.
In query mode, this flag needs a value.
|
|
altAttribute(aa)
|
string
|
|
|
Define an alternate attribute which will also receive the same
values. There can be multiple such flags.
In query mode, this flag needs a value.
|
|
uiName(ui)
|
string
|
|
|
UI name. Default is the attribute name.
In query mode, this flag needs a value.
|
|
attrType(at)
|
string
|
|
|
Paintable attribute type.
Supported types: intArray, doubleArray, vectorArray, multiInteger, multiFloat, multiDouble, multiVector.
In query mode, this flag needs a value.
|
|
remove(rm)
|
boolean
|
|
|
Make the attribute not paintable any more.
In query mode, this flag needs a value.
|
|
clearAll(ca)
|
boolean
|
|
|
Removes all paintable attribute definitions.
In query mode, this flag needs a value.
|
|
activate(ac)
|
boolean
|
|
|
Activate / deactivate the given paintable attribute. Used
to filter out some nodes in the attribute paint tool.
In query mode, this flag needs a value.
|
|
activateAll(aca)
|
boolean
|
|
|
Activate / deactivate all the registered paintable attributes. Used
to filter out some nodes in the attribute paint tool.
In query mode, this flag needs a value.
|
|
|
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.
|
None
attributes, paint
artAttrCtx, artAttrPaintVertexCtx, artFluidAttrCtx, artPuttyCtx, artSelectCtx, artSetPaintCtx, artUserPaintCtx
import maya.cmds as cmds
# Make particle.mass paintable.
cmds.makePaintable( 'particle', 'mass', attrType='doubleArray' )
# Make particle.goalPP paintable, with a ui name myGoalPP.
# Also make the goalPP0 attribute painted simultaneously
cmds.makePaintable( 'particle', 'goalPP', attrType='doubleArray', ui='myGoalPP', altAttribute='goalPP0' )
# Make weightGeometryFilter.weights paintable. Define
# weightGeometryFilter as a deformer node.
cmds.makePaintable( 'weightGeometryFilter', 'weights', attrType='multiFloat', sm='deformer' )
# Make all the attributes paintable on the artAttrPaintTest node.
cmds.makePaintable( 'artAttrPaintTest', 'intArray', attrType='intArray' )
cmds.makePaintable( 'artAttrPaintTest', 'dblArray', attrType='doubleArray' )
cmds.makePaintable( 'artAttrPaintTest', 'vecArray', attrType='vectorArray' )
cmds.makePaintable( 'artAttrPaintTest', 'intMulti', attrType='multiInteger' )
cmds.makePaintable( 'artAttrPaintTest', 'fltMulti', attrType='multiFloat' )
cmds.makePaintable( 'artAttrPaintTest', 'dblMulti', attrType='multiDouble' )
cmds.makePaintable( 'artAttrPaintTest', 'flt3Multi', attrType='multiVector' )
cmds.makePaintable( 'artAttrPaintTest', 'dbl3Multi', attrType='multiVector' )