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

Synopsis

makePaintable [-activate boolean] [-activateAll boolean] [-altAttribute string] [-attrType string] [-clearAll] [-remove] [-shapeMode string] [-uiName string]

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.

Flags

activate, activateAll, altAttribute, attrType, clearAll, remove, shapeMode, uiName
Long name (short name) [argument types] Properties
-shapeMode(-sm) string createquery
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 createquerymultiuse
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 createquery
UI name. Default is the attribute name.

In query mode, this flag needs a value.
-attrType(-at) string createquery
Paintable attribute type. Supported types: intArray, doubleArray, vectorArray, multiInteger, multiFloat, multiDouble, multiVector.

In query mode, this flag needs a value.
-remove(-rm) createquery
Make the attribute not paintable any more.

In query mode, this flag needs a value.
-clearAll(-ca) createquery
Removes all paintable attribute definitions.

In query mode, this flag needs a value.
-activate(-ac) boolean createquery
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 createquery
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 be used more than once in a command

Return value


None

Keywords

attributes, paint

Related

artAttrCtx, artAttrPaintVertexCtx, artFluidAttrCtx, artPuttyCtx, artSelectCtx, artSetPaintCtx, artUserPaintCtx

MEL examples

// Make particle.mass paintable.
makePaintable -attrType "doubleArray" "particle" "mass";
// Make particle.goalPP paintable, with a ui name myGoalPP.
// Also make the goalPP0 attribute painted simultaneously
makePaintable -attrType "doubleArray" -ui "myGoalPP" -altAttribute "goalPP0" "particle" "goalPP";
// Make weightGeometryFilter.weights paintable. Define
// weightGeometryFilter as a deformer node.
makePaintable -attrType "multiFloat" -sm "deformer" "weightGeometryFilter" "weights";
// Make all the attributes paintable on the artAttrPaintTest node.
makePaintable -attrType "intArray"     "artAttrPaintTest" "intArray";
makePaintable -attrType "doubleArray"  "artAttrPaintTest" "dblArray";
makePaintable -attrType "vectorArray"  "artAttrPaintTest" "vecArray";
makePaintable -attrType "multiInteger" "artAttrPaintTest" "intMulti";
makePaintable -attrType "multiFloat"   "artAttrPaintTest" "fltMulti";
makePaintable -attrType "multiDouble"  "artAttrPaintTest" "dblMulti";
makePaintable -attrType "multiVector"  "artAttrPaintTest" "flt3Multi";
makePaintable -attrType "multiVector"  "artAttrPaintTest" "dbl3Multi";