Go to: Return value. Flags.

Synopsis

This command is used to paint properties (such as density) of selected fluid volumes.

Return value

none

Flags

accopacity, autoSave, brushalignment, brushfeedback, clear, currentPaintableFluid, delaySelectionChanged, displayAsRender, displayVelocity, doAutoSave, dragSlider, edit, exists, expandfilename, exportfilemode, exportfilesave, exportfilesizex, exportfilesizey, exportfiletype, history, image1, image2, image3, importfileload, importfilemode, importreassign, lowerradius, mappressure, name, opacity, outline, outwhilepaint, paintmode, profileShapeFile, projective, property, query, radius, reflection, reflectionAxis, rgbValue, showactive, stampProfile, surfaceConformedBrushVertices, tablet, tangentOutline, useStrokeDirection, usepressure, velocity

Long name (short name)[argument types]Properties
-query (-q)
Puts the command in query mode so that it will return the value of the specified flag.
-edit (-e)
Puts the command in edit mode so that it will change the values of the specified flags
-exists (-ex)
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
-image1 (-i1) string
-image2 (-i2) string
-image3 (-i3) stringquerycreateedit
Contexts support up to three icons that represent the tool associated with the context.
-history (-ch) booleancreate
If this is a tool command, turn the construction history on for the tool in question.
-name (-n) stringcreate
If this is a tool command, name the tool appropriately.
-dragSlider (-dsl) stringcreateedit
Sets the current brush drag state for resizing or offsetting the brush (like the 'b' and 'm' default hotkeys). The string argument is one of: "radius", "lowradius", "opacity", "value" or "none". C: Default is "none".
-opacity (-op) floatquerycreateedit
Sets the brush opacity. C: Default is 1.0. Q: When queried, it returns a float.
-accopacity (-aco) booleanquerycreateedit
Sets opacity accumulation on/off. C: Default is false (Except for sculpt tool for which it is true by default). Q: When queried, it returns a boolean.
-radius (-r) floatquerycreateedit
Sets the size of the brush. C: Default is 1.0 cm. Q: When queried, it returns a float.
-lowerradius (-lr) floatquerycreateedit
Sets the lower size of the brush (only apply on tablet).
-stampProfile (-stP) stringquerycreateedit
Sets the brush profile of the current stamp. Currently, the following profiles are supported: "gaussian", "soft", "solid" and "square". C: Default is gaussian. Q: When queried, it returns a string.
-profileShapeFile (-psf) stringqueryedit
Passes a name of the image file for the stamp shape profile.
-brushalignment (-bra) booleanquerycreateedit
Specifies the path brush alignemnt. If true, the brush will align to stroke path, otherwise it will align to up vector. C: Default is true. Q: When queried, it returns a boolean.
-clear (-clr) createedit
Floods all cvs/vertices to the current value.
-usepressure (-up) booleanquerycreateedit
Sets the tablet pressure on/off. C: Default is false. Q: When queried, it returns a boolean.
-mappressure (-mp) stringquerycreateedit
Sets the tablet pressure mapping when the table is used. There are four options: "none" - the pressure has no effect, "opacity" - the pressure is mapped to the opacity, "radius" - the is mapped to modify the radius of the brush, "both" - the pressure modifies both the opacity and the radius. C: Default is "none". Q: When queried, it returns a string.
-outline (-o) booleanquerycreateedit
Specifies if the brush should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
-outwhilepaint (-owp) booleanquerycreateedit
Specifies if the brush outline should be drawn while painting. C: Default is FALSE. Q: When queried, it returns a boolean.
-brushfeedback (-bf) booleanquerycreateedit
Specifies if the brush additional feedback should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
-showactive (-sa) booleanquerycreateedit
Sets on/off the display of the surface isoparms. C: Default is TRUE. Q: When queried, it returns a boolean.
-paintmode (-pm) stringquerycreateedit
Specifies the paint mode. There are two possibilities: "screen" and "tangent". C: Default is "screen". Q: When queried, it returns a string.
-projective (-prm) booleanquerycreateedit
Specifies the projective paint mode. C: Default is 'false'. Q: When queried, it returns a boolean.
-reflection (-rn) booleanquerycreateedit
Specifies the reflection mode. C: Default is 'false'. Q: When queried, it returns a boolean.
-reflectionAxis (-ra) stringquerycreateedit
Specifies the reflection axis. There are three possibilities: "x", "y" and "z". C: Default is "x". Q: When queried, it returns a string.
-importfileload (-ifl) stringedit
Load the attribute map a specified file.
-importreassign (-irm) booleanquerycreateedit
Specifies if the multiply atrribute maps are to be reassigned while importing. Only maps previously exported from within Artisan can be reassigned. C: Default is FALSE. Q: When queried, it returns a boolean.
-importfilemode (-ifm) stringquerycreateedit
Specifies the channel to import. The valid entries here are: "alpha", "luminance", "red", "green", "blue", and "rgb" C: Default is "alpha". Q: When queried, it returns a string.
-expandfilename (-eef) booleancreateedit
If true, it will expand the name of the export file and concatenate it with the surface name. Otherwise it will take the name as it is. C: Default is true.
-exportfilesave (-esf) stringedit
Exports the attribute map and saves to a specified file.
-exportfilemode (-efm) stringquerycreateedit
Specifies the export channel.The valid entries here are: "alpha", "luminance", "rgb", "rgba". C: Default is "luminance/rgb". Q: When queried, it returns a string.
-exportfilesizex (-fsx) integerquerycreateedit
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
-exportfilesizey (-fsy) integerquerycreateedit
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
-exportfiletype (-eft) stringquerycreateedit
Specifies the image file format. It can be one of the following: "iff", "tiff", "jpeg", "alias", "rgb", "fit" "postScriptEPS", "softimage", "wavefrontRLA", "wavefrontEXP". C: default is tiff. Q: When queried, it returns a string.
-tablet (-tab) query
Returns true if the tablet device is present, false if it is absent
-surfaceConformedBrushVertices (-scv) booleanquerycreateedit
Enables/disables the the display of the effective brush area as affected vertices.
-tangentOutline (-to) booleanquerycreateedit
Enables/disables the display of the brush circle tangent to the surface.
-property (-p) stringquerycreateedit
Specifies a property to paint on the fluid. Valid values are "color", "density", "densityAndColor," "densityAndFuel," "temperature," "fuel", "velocity".
-rgbValue (-rgb) float float floatquerycreateedit
Specifies the values of the red, green, and blue components of the color to use when painting the property "color."
-velocity (-v) float float floatquerycreateedit
Specifies the values of the x, y, and z components of the velocity to use when painting the property "velocity".
-useStrokeDirection (-usd) booleanquerycreateedit
Applicable only during "velocity" painting. Specifies whether the value of the painted velocity should come from the direction of the brush stroke, overriding the value specified by the -v/-velocity flag.
-autoSave (-as) stringquerycreateedit
A MEL command to save the fluid state. Called before an event which could overwrite unsaved values of painted fluid properties. Such events include: changing current time, changing the current paintable property, and exiting the paint tool. (To turn auto-save off, pass in an empty-valued string argument: e.g., "".)
-doAutoSave (-das) toggleedit
Execute the -autoSave command if there are unsaved painted fluid properties.
-displayAsRender (-dar) booleanquerycreateedit
When true, sets the "Shaded Display" attribute of the fluid to "AsRender": all fluid properties displayed as hardware rendered. When false, displays only the currently selected paintable attribute of the fluid.
-displayVelocity (-dv) booleanquerycreateedit
Turns on/off velocity display, independently of the above "dar/displayAsRender" setting. Use this flag to enable velocity display while only displaying density, for example.
-delaySelectionChanged (-dsl) booleanquerycreateedit
Internal use only. Under normal conditions, the tool responds to changes to the selection list so it can update its list of paintable geometry. When -dsl true is used, the tool will not update its paintable list until a corresponding -dsl false is called.
-currentPaintableFluid (-cpf) query
Query the name of the fluid on which this context is currently painting. Returns string.

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