pymel.core.context.artFluidAttrCtx

artFluidAttrCtx(*args, **kwargs)

This command is used to paint properties (such as density) of selected fluid volumes. In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
accopacity (aco) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
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) unicode  
   
afterStrokeCmd (asc) unicode  
   
alphaclamp (alc) unicode  
   
alphaclamplower (acl) float  
   
alphaclampupper (acu) float  
   
attrSelected (asl) unicode  
   
autoSave (autoSave) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) unicode  
   
brushalignment (bra) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if the brush additional feedback should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
clamp (cl) unicode  
   
clamplower (cll) float  
   
clampupper (clu) float  
   
clear (clr) bool ../../../_images/create.gif ../../../_images/edit.gif
 
Floods all cvs/vertices to the current value.
colorAlphaValue (cl1) float  
   
colorRGBAValue (cl4) float, float, float, float  
   
colorRGBValue (cl3) float, float, float  
   
colorRamp (cr) unicode  
   
colorfeedback (cf) bool  
   
colorfeedbackOverride (cfo) bool  
   
colorrangelower (crl) float  
   
colorrangeupper (cru) float  
   
currentPaintableFluid (cpf) unicode ../../../_images/query.gif
 

Query the name of the fluid on which this context is currently painting. Returns string.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

dataTypeIndex (dti) int  
   
delaySelectionChanged (dsc) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool  
   
displayAsRender (dar) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool ../../../_images/edit.gif
 
Execute the -autoSave command if there are unsaved painted fluid properties.
dragSlider (dsl) unicode ../../../_images/create.gif ../../../_images/edit.gif
 

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) unicode  
   
dynclonemode (dcm) bool  
   
exists (ex) bool ../../../_images/create.gif
 
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
expandfilename (eef) bool ../../../_images/create.gif ../../../_images/edit.gif
 
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  
   
exportfilemode (efm) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
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) unicode ../../../_images/edit.gif
 
Exports the attribute map and saves to a specified file.
exportfilesizex (fsx) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
exportfilesizey (fsy) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer.
exportfiletype (eft) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool  
   
history (ch) bool ../../../_images/create.gif
 
If this is a tool command, turn the construction history on for the tool in question.
image1 (i1) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image2 (i2) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
   
image3 (i3) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Contexts support up to three icons that represent the tool associated with the context.
importfileload (ifl) unicode ../../../_images/edit.gif
 
Load the attribute map a specified file.
importfilemode (ifm) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool  
   
lastRecorderCmd (lrc) unicode  
   
lastStampName (lsn) unicode  
   
lowerradius (lr) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Sets the lower size of the brush (only apply on tablet).
makeStroke (mst) int  
   
mappressure (mp) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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.

maxvalue (mxv) float  
   
minvalue (miv) float  
   
name (n) unicode ../../../_images/create.gif
 
If this is a tool command, name the tool appropriately.
objattrArray (oaa) unicode  
   
opacity (op) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Sets the brush opacity. C: Default is 1.0. Q: When queried, it returns a float.
outline (o) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if the brush should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean.
outwhilepaint (owp) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies if the brush outline should be drawn while painting. C: Default is FALSE. Q: When queried, it returns a boolean.
paintNodeArray (pna) unicode  
   
paintattrselected (pas) unicode  
   
paintmode (pm) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the paint mode. There are two possibilities: “screen” and “tangent”. C: Default is “screen”. Q: When queried, it returns a string.
paintoperationtype (pot) unicode  
   
pickColor (pcm) bool  
   
pickValue (pv) bool  
   
playbackCursor (plc) float, float  
   
playbackPressure (plp) float  
   
preserveclonesource (pcs) bool  
   
profileShapeFile (psf) unicode ../../../_images/query.gif ../../../_images/edit.gif
 
Passes a name of the image file for the stamp shape profile.
projective (prm) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the projective paint mode. C: Default is ‘false’. Q: When queried, it returns a boolean.
property (p) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies a property to paint on the fluid. Valid values are “color”, “density”, “densityAndColor,” “densityAndFuel,” “temperature,” “fuel”, “velocity”.
radius (r) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Sets the size of the brush. C: Default is 1.0 cm. Q: When queried, it returns a float.
rampMaxColor (rxc) float, float, float  
   
rampMinColor (rmc) float, float, float  
   
record (rec) bool  
   
reflection (rn) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the reflection mode. C: Default is ‘false’. Q: When queried, it returns a boolean.
reflectionaboutorigin (rno) bool  
   
reflectionaxis (ra) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
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 ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the values of the red, green, and blue components of the color to use when painting the property “color.”
screenRadius (scR) float  
   
selectclonesource (scs) bool  
   
selectedattroper (sao) unicode  
   
showactive (sa) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Sets on/off the display of the surface isoparms. C: Default is TRUE. Q: When queried, it returns a boolean.
stampDepth (stD) float  
   
stampProfile (stP) unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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.

stampSpacing (stS) float  
   
strokesmooth (ssm) unicode  
   
| |
scv)** | bool | .. image:: /images/create.gif |
| | .. image:: /images/query.gif |
| | .. image:: /images/edit.gif |
 
Enables/disables the the display of the effective brush area as affected vertices.
tablet (tab) bool ../../../_images/query.gif
 
Returns true if the tablet device is present, false if it is absent
tangentOutline (to) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Enables/disables the display of the brush circle tangent to the surface.
toolOffProc (tfp) unicode  
   
toolOnProc (top) unicode  
   
useColorRamp (ucr) bool  
   
useMaxMinColor (umc) bool  
   
useStrokeDirection (usd) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

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) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Sets the tablet pressure on/off. C: Default is false. Q: When queried, it returns a boolean.
value (val) float  
   
velocity (v) float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Specifies the values of the x, y, and z components of the velocity to use when painting the property “velocity”.
whichTool (wst) unicode  
   
worldRadius (wlR) float  
   

Derived from mel command maya.cmds.artFluidAttrCtx

Example:

import pymel.core as pm

import maya.cmds as cmds

# Create a new fluidAttr paint context, then switch to it
pm.artFluidAttrCtx('artFluidAttrCtx1')
# Result: u'artFluidAttrCtx1' #
pm.setToolTo('artFluidAttrCtx1')

# Set to paint the color property on the fluid
pm.artFluidAttrCtx('artFluidAttrCtx1', edit=True, property='color')
# Result: u'artFluidAttrCtx1' #

Previous topic

pymel.core.context.artBaseCtx

Next topic

pymel.core.context.artPuttyCtx

Core

Core Modules

Other Modules

This Page