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

Synopsis

artFluidAttrCtx [-accopacity boolean] [-activeListChangedProc string] [-afterStrokeCmd string] [-alphaclamp string] [-alphaclamplower float] [-alphaclampupper float] [-attrSelected string] [-autoSave string] [-beforeStrokeCmd string] [-brushalignment boolean] [-brushfeedback boolean] [-clamp string] [-clamplower float] [-clampupper float] [-clear] [-colorAlphaValue float] [-colorRGBAValue float float float float] [-colorRGBValue float float float] [-colorRamp string] [-colorfeedback boolean] [-colorfeedbackOverride boolean] [-colorrangelower float] [-colorrangeupper float] [-currentPaintableFluid string] [-dataTypeIndex int] [-delaySelectionChanged boolean] [-disablelighting boolean] [-displayAsRender boolean] [-displayVelocity boolean] [-doAutoSave] [-dragSlider string] [-duringStrokeCmd string] [-dynclonemode boolean] [-exists] [-expandfilename boolean] [-exportaspectratio float] [-exportfilemode string] [-exportfilesave string] [-exportfilesizex int] [-exportfilesizey int] [-exportfiletype string] [-filterNodes] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-importfileload string] [-importfilemode string] [-importreassign boolean] [-interactiveUpdate boolean] [-lastRecorderCmd string] [-lastStampName string] [-lowerradius float] [-makeStroke uint] [-mappressure string] [-maxvalue float] [-minvalue float] [-name string] [-objattrArray string] [-opacity float] [-outline boolean] [-outwhilepaint boolean] [-paintNodeArray string] [-paintattrselected string] [-paintmode string] [-paintoperationtype string] [-pickColor boolean] [-pickValue] [-playbackCursor float float] [-playbackPressure float] [-preserveclonesource boolean] [-profileShapeFile string] [-projective boolean] [-property string] [-radius float] [-rampMaxColor float float float] [-rampMinColor float float float] [-record boolean] [-reflection boolean] [-reflectionaboutorigin boolean] [-reflectionaxis string] [-rgbValue float float float] [-screenRadius float] [-selectclonesource boolean] [-selectedattroper string] [-showactive boolean] [-stampDepth float] [-stampProfile string] [-stampSpacing float] [-strokesmooth string] [-surfaceConformedBrushVertices boolean] [-tablet] [-tangentOutline boolean] [-toolOffProc string] [-toolOnProc string] [-useColorRamp boolean] [-useMaxMinColor boolean] [-useStrokeDirection boolean] [-usepressure boolean] [-value float] [-velocity float float float] [-whichTool string] [-worldRadius float]

artFluidAttrCtx is undoable, queryable, and editable.

This is a context command to set the flags on the artAttrContext, which is the base context for attribute painting operations. All commands require the name of the context as the last argument as this provides the name of the context to create, edit or query.

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

Return value

None

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

Flags

accopacity, activeListChangedProc, afterStrokeCmd, alphaclamp, alphaclamplower, alphaclampupper, attrSelected, autoSave, beforeStrokeCmd, brushalignment, brushfeedback, clamp, clamplower, clampupper, clear, colorAlphaValue, colorRGBAValue, colorRGBValue, colorRamp, colorfeedback, colorfeedbackOverride, colorrangelower, colorrangeupper, currentPaintableFluid, dataTypeIndex, delaySelectionChanged, disablelighting, displayAsRender, displayVelocity, doAutoSave, dragSlider, duringStrokeCmd, dynclonemode, exists, expandfilename, exportaspectratio, exportfilemode, exportfilesave, exportfilesizex, exportfilesizey, exportfiletype, filterNodes, history, image1, image2, image3, importfileload, importfilemode, importreassign, interactiveUpdate, lastRecorderCmd, lastStampName, lowerradius, makeStroke, mappressure, maxvalue, minvalue, name, objattrArray, opacity, outline, outwhilepaint, paintNodeArray, paintattrselected, paintmode, paintoperationtype, pickColor, pickValue, playbackCursor, playbackPressure, preserveclonesource, profileShapeFile, projective, property, radius, rampMaxColor, rampMinColor, record, reflection, reflectionaboutorigin, reflectionaxis, rgbValue, screenRadius, selectclonesource, selectedattroper, showactive, stampDepth, stampProfile, stampSpacing, strokesmooth, surfaceConformedBrushVertices, tablet, tangentOutline, toolOffProc, toolOnProc, useColorRamp, useMaxMinColor, useStrokeDirection, usepressure, value, velocity, whichTool, worldRadius
Long name (short name) Argument types Properties
-accopacity(-aco) boolean createqueryedit
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.
-activeListChangedProc(-alp) string createqueryedit
Accepts a string that contains a MEL command that is invoked whenever the active list changes. There may be some situations where the UI, for example, needs to be updated, when objects are selected/deselected in the scene. In query mode, the name of the currently registered MEL command is returned and this will be an empty string if none is defined.
-afterStrokeCmd(-asc) string createqueryedit
The passed string is executed as a MEL command immediately after the end of a stroke. C: Default is no command. Q: When queried, it returns the current command
-alphaclamp(-alc) string createqueryedit
Specifies if the weight value should be alpha clamped to the lower and upper bounds. There are four options here: "none" - no clamping is performed, "lower" - clamps only to the lower bound, "upper" - clamps only to the upper bounds, "both" - clamps to the lower and upper bounds. C: Default is "none". Q: When queried, it returns a string.
-alphaclamplower(-acl) float createqueryedit
Specifies the lower bound for the alpha values. C: Default is 0.0. Q: When queried, it returns a float.
-alphaclampupper(-acu) float createqueryedit
Specifies the upper bound for the alpha values. C: Default is 1.0. Q: When queried, it returns a float.
-attrSelected(-asl) string query
Returns a name of the currently selected attribute. Q: When queried, it returns a string.
-autoSave(-as) string createqueryedit
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., "".)
-beforeStrokeCmd(-bsc) string createqueryedit
The passed string is executed as a MEL command immediately before the start of a stroke. C: Default is no command. Q: When queried, it returns the current command
-brushalignment(-bra) boolean createqueryedit
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.
-brushfeedback(-brf) boolean createqueryedit
Specifies if the brush additional feedback should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
-clamp(-cl) string createqueryedit
Specifies if the weight value should be clamped to the lower and upper bounds. There are four options here: "none" - no clamping is performed, "lower" - clamps only to the lower bound, "upper" - clamps only to the upper bounds, "both" - clamps to the lower and upper bounds. C: Default is "none". Q: When queried, it returns a string.
-clamplower(-cll) float createqueryedit
Specifies the lower bound for the values. C: Default is 0.0. Q: When queried, it returns a float.
-clampupper(-clu) float createqueryedit
Specifies the upper bound for the values. C: Default is 1.0. Q: When queried, it returns a float.
-clear(-clr) createedit
Floods all cvs/vertices to the current value.
-colorAlphaValue(-cl1) float createqueryedit
The Alpha value of the color.
-colorRGBAValue(-cl4) float float float float createqueryedit
The RGBA value of the color.
-colorRGBValue(-cl3) float float float createqueryedit
The RGB value of the color.
-colorRamp(-cr) string createqueryedit
Allows a user defined color ramp to be used to map values to colors.
-colorfeedback(-cf) boolean createqueryedit
Sets on/off the color feedback display. C: Default is FALSE. Q: When queried, it returns a boolean.
-colorfeedbackOverride(-cfo) boolean createqueryedit
Sets on/off the color feedback override. C: Default is FALSE. Q: When queried, it returns a boolean.
-colorrangelower(-crl) float createqueryedit
Specifies the value that maps to black when color feedback mode is on. C: Default is 0.0. Q: When queried, it returns a float.
-colorrangeupper(-cru) float createqueryedit
Specifies the value that maps to the maximum color when color feedback mode is on. C: Default is 1.0. Q: When queried, it returns a float.
-currentPaintableFluid(-cpf) string query
Query the name of the fluid on which this context is currently painting. Returns string.
-dataTypeIndex(-dti) int queryedit
When the selected paintable attribute is a vectorArray, it specifies which field to paint on.
-delaySelectionChanged(-dsc) boolean createqueryedit
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.
-disablelighting(-dl) boolean createqueryedit
If color feedback is on, this flag determines whether lighting is disabled or not for the surfaces that are affected. C: Default is FALSE. Q: When queried, it returns a boolean.
-displayAsRender(-dar) boolean createqueryedit
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) boolean createqueryedit
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.
-doAutoSave(-das) edit
Execute the -autoSave command if there are unsaved painted fluid properties.
-dragSlider(-dsl) string createedit
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", "depth", "displacement", "uvvector" or "none". C: Default is "none".
-duringStrokeCmd(-dsk) string createqueryedit
The passed string is executed as a MEL command during the stroke, each time the mouse is dragged. C: Default is no command. Q: When queried, it returns the current command
-dynclonemode(-dcm) boolean createqueryedit
Enable or disable dynamic clone mode.
-exists(-ex) create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-expandfilename(-eef) boolean createedit
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.
-exportaspectratio(-ear) float createqueryedit
Value of aspect ratio for export
-exportfilemode(-efm) string createqueryedit
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.
-exportfilesave(-esf) string edit
Exports the attribute map and saves to a specified file.
-exportfilesizex(-fsx) int createqueryedit
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
-exportfilesizey(-fsy) int createqueryedit
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
-exportfiletype(-eft) string createqueryedit
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.
-filterNodes(-fon) edit
Sets the node filter.
-history(-ch) boolean create
If this is a tool command, turn the construction history on for the tool in question.
-image1(-i1) string createqueryedit
First of three possible icons representing the tool associated with the context.
-image2(-i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
-image3(-i3) string createqueryedit
Third of three possible icons representing the tool associated with the context.
-importfileload(-ifl) string edit
Load the attribute map a specified file.
-importfilemode(-ifm) string createqueryedit
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.
-importreassign(-irm) boolean createqueryedit
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.
-interactiveUpdate(-iu) boolean createqueryedit
Specifies how often to transfer the painted values into the attribute. TRUE: transfer them "continuously" (many times per stroke) FALSE: transfer them only at the end of a stroke (on mouse button release). C: Default is TRUE. Q: When queried, it returns a boolean.
-lastRecorderCmd(-lrc) string createqueryedit
Value of last recorded command.
-lastStampName(-lsn) string createqueryedit
Value of the last stamp name.
-lowerradius(-lr) float createqueryedit
Sets the lower size of the brush (only apply on tablet).
-makeStroke(-mst) uint createqueryeditmultiuse
Stroke point values.
-mappressure(-mp) string createqueryedit
Sets the tablet pressure mapping when the table is used. There are three options: "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 "Opacity". Q: When queried, it returns a string.
-maxvalue(-mxv) float createqueryedit
Specifies the maximum value for each attribute. C: Default is 1.0. Q: When queried, it returns a float.
-minvalue(-miv) float createqueryedit
Specifies the minimum value for each attribute. C: Default is 0.0. Q: When queried, it returns a float.
-name(-n) string create
If this is a tool command, name the tool appropriately.
-objattrArray(-oaa) string query
An array of all paintable attributes. Each element of the array is a string with the following information: NodeType.NodeName.AttributeName.MenuType. *MenuType: type (level) of the item in the Menu (UI). Q: When queried, it returns a string.
-opacity(-op) float createqueryedit
Sets the brush opacity. C: Default is 1.0. Q: When queried, it returns a float.
-outline(-o) boolean createqueryedit
Specifies if the brush should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
-outwhilepaint(-owp) boolean createqueryedit
Specifies if the brush outline should be drawn while painting. C: Default is FALSE. Q: When queried, it returns a boolean.
-paintNodeArray(-pna) string query
An array of paintable nodes. Q: When queried, it returns a string.
-paintattrselected(-pas) string edit
An array of selected paintable attributes. Each element of the array is a string with the following information: NodeType.NodeName.AttributeName.
-paintmode(-pm) string createqueryedit
Specifies the paint mode. There are two possibilities: "screen" and "tangent". C: Default is "screen". Q: When queried, it returns a string.
-paintoperationtype(-pot) string createqueryedit
Specifies the operation type used by the Paint Tool. Currently, we support the following paint modes: "Paint", "Smear", "Blur", "Erase" and "Clone". Default is "Paint".
-pickColor(-pcm) boolean createqueryedit
Set pick color mode on or off
-pickValue(-pv) createqueryedit
Toggle for picking
-playbackCursor(-plc) float float createqueryeditmultiuse
Values for the playback cursor.
-playbackPressure(-plp) float createqueryeditmultiuse
Valus for the playback pressure.
-preserveclonesource(-pcs) boolean createqueryedit
Whether or not to preserve a clone source.
-profileShapeFile(-psf) string queryedit
Passes a name of the image file for the stamp shape profile.
-projective(-prm) boolean createqueryedit
Specifies the projective paint mode. C: Default is 'false'. Q: When queried, it returns a boolean.
-property(-p) string createqueryedit
Specifies a property to paint on the fluid. Valid values are "color", "density", "densityAndColor," "densityAndFuel," "temperature," "fuel", "velocity".
-radius(-r) float createqueryedit
Sets the size of the brush. C: Default is 1.0 cm. Q: When queried, it returns a float.
-rampMaxColor(-rxc) float float float createqueryedit
Defines a special color to be used when the value is greater than or equal to the maximum value.
-rampMinColor(-rmc) float float float createqueryedit
Defines a special color to be used when the value is less than or equal to the minimum value.
-record(-rec) boolean createqueryedit
Toggle on for recording.
-reflection(-rn) boolean createqueryedit
Specifies the reflection mode. C: Default is 'false'. Q: When queried, it returns a boolean.
-reflectionaboutorigin(-rno) boolean createqueryedit
Toggle on to reflect about the origin
-reflectionaxis(-ra) string createqueryedit
Specifies the reflection axis. There are three possibilities: "x", "y" and "z". C: Default is "x". Q: When queried, it returns a string.
-rgbValue(-rgb) float float float createqueryedit
Specifies the values of the red, green, and blue components of the color to use when painting the property "color."
-screenRadius(-scR) float createqueryedit
Brush radius on the screen
-selectclonesource(-scs) boolean createqueryedit
Toggle on to select the clone source
-selectedattroper(-sao) string createqueryedit
Sets the edit weight operation. Four edit weights operations are provided : "absolute" - the value of the weight is replaced by the current one, "additive" - the value of the weight is added to the current one, "scale" - the value of the weight is multiplied by the current one, "smooth" - the value of the weight is divided by the current one. C: Default is "absolute". Q: When queried, it returns a string.
-showactive(-sa) boolean createqueryedit
Sets on/off the display of the surface isoparms. C: Default is TRUE. Q: When queried, it returns a boolean.
-stampDepth(-stD) float createqueryedit
Depth of the stamps
-stampProfile(-stP) string createqueryedit
Sets the brush profile of the current stamp. Currently, the following profiles are supported: "gaussian", "poly", "solid" and "square". C: Default is gaussian. Q: When queried, it returns a string.
-stampSpacing(-stS) float createqueryedit
Specifies the stamp spacing. Default is 1.0.
-strokesmooth(-ssm) string createqueryedit
Stroke smoothing type name
-surfaceConformedBrushVertices(-scv) boolean createqueryedit
Enables/disables the the display of the effective brush area as affected vertices.
-tablet(-tab) query
Returns true if the tablet device is present, false if it is absent
-tangentOutline(-to) boolean createqueryedit
Enables/disables the display of the brush circle tangent to the surface.
-toolOffProc(-tfp) string createqueryedit
Accepts a strings describing the name of a MEL procedure that is invoked whenever the tool is turned off. For example, cloth invokes "clothPaintToolOff" when the cloth paint tool is turned on. Define this callback if your tool requires special functionality when your tool is deactivated. It is typical that if you implement a toolOffProc you will want to implement a toolOnProc as well (see the -toolOnProc flag. In query mode, the name of the currently registered MEL command is returned and this will be an empty string if none is defined.
-toolOnProc(-top) string createqueryedit
Accepts a strings describing the name of a MEL procedure that is invoked whenever the tool is turned on. For example, cloth invokes "clothPaintToolOn" when the cloth paint tool is turned on. Define this callback if your tool requires special functionality when your tool is activated. It is typical that if you implement a toolOnProc you will want to implement a toolOffProc as well (see the -toolOffProc flag. In query mode, the name of the currently registered MEL command is returned and this will be an empty string if none is defined.
-useColorRamp(-ucr) boolean createqueryedit
Specifies whether the user defined color ramp should be used to map values from to colors. If this is turned off, the default greyscale feedback will be used.
-useMaxMinColor(-umc) boolean createqueryedit
Specifies whether the out of range colors should be used. See rampMinColor and rampMaxColor flags for further details.
-useStrokeDirection(-usd) boolean createqueryedit
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.
-usepressure(-up) boolean createqueryedit
Sets the tablet pressure on/off. C: Default is false. Q: When queried, it returns a boolean.
-value(-val) float createqueryedit
Specifies the value for each attribute. C: Default is 0.0. Q: When queried, it returns a float.
-velocity(-v) float float float createqueryedit
Specifies the values of the x, y, and z components of the velocity to use when painting the property "velocity".
-whichTool(-wst) string createqueryedit
The string defines the name of the tool to be used for the Artisan context. An example is "artClothPaint". In query mode, the tool name for the given context is returned. Note: due to the way MEL works, always specify the -query flag last when specifying a flag that takes arguments.
-worldRadius(-wlR) float createqueryedit
Radius in worldspace

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

// Create a new fluidAttr paint context, then switch to it
artFluidAttrCtx artFluidAttrCtx1;
setToolTo artFluidAttrCtx1;

// Set to paint the color property on the fluid
artFluidAttrCtx -e -property color artFluidAttrCtx1;