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 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 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 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 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 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 Query the name of the fluid on which this context is currently painting. Returns string. dataTypeIndex / dti int delaySelectionChanged / dsc bool 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 When true, sets the Shaded Displayattribute 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 Turns on/off velocity display, independently of the above dar/displayAsRendersetting. Use this flag to enable velocity display while only displaying density, for example. doAutoSave / das bool Execute the -autoSave command if there are unsaved painted fluid properties. dragSlider / dsl unicode 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, uvvectoror none. C: Default is none. duringStrokeCmd / dsk unicode dynclonemode / dcm bool exists / ex bool Returns true or false depending upon whether the specified object exists. Other flags are ignored. expandfilename / eef bool 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 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 Exports the attribute map and saves to a specified file. exportfilesizex / fsx int Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer. exportfilesizey / fsy int Specifies the width of the attribute map to export. C: Default width is 256. Q: When queried, it returns an integer. exportfiletype / eft unicode Specifies the image file format. It can be one of the following: iff, tiff, jpeg, alias, rgb, fitpostScriptEPS, softimage, wavefrontRLA, wavefrontEXP. C: default is tiff. Q: When queried, it returns a string. filterNodes / fon bool history / ch bool If this is a tool command, turn the construction history on for the tool in question. image1 / i1 unicode First of three possible icons representing the tool associated with the context. image2 / i2 unicode Second of three possible icons representing the tool associated with the context. image3 / i3 unicode Third of three possible icons representing the tool associated with the context. importfileload / ifl unicode Load the attribute map a specified file. importfilemode / ifm unicode Specifies the channel to import. The valid entries here are: alpha, luminance, red, green, blue, and rgbC: Default is alpha. Q: When queried, it returns a string. importreassign / irm bool 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 Sets the lower size of the brush (only apply on tablet). makeStroke / mst int mappressure / mp unicode 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 If this is a tool command, name the tool appropriately. objattrArray / oaa unicode opacity / op float Sets the brush opacity. C: Default is 1.0. Q: When queried, it returns a float. outline / o bool Specifies if the brush should be drawn. C: Default is TRUE. Q: When queried, it returns a boolean. outwhilepaint / owp bool 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 Specifies the paint mode. There are two possibilities: screenand 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 Passes a name of the image file for the stamp shape profile. projective / prm bool Specifies the projective paint mode. C: Default is ‘false’. Q: When queried, it returns a boolean. property / p unicode Specifies a property to paint on the fluid. Valid values are color, density, densityAndColor,densityAndFuel,temperature,fuel, velocity. radius / r float 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 Specifies the reflection mode. C: Default is ‘false’. Q: When queried, it returns a boolean. reflectionaboutorigin / rno bool reflectionaxis / ra unicode Specifies the reflection axis. There are three possibilities: x, yand z. C: Default is x. Q: When queried, it returns a string. rgbValue / rgb float, float, float 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 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 Sets the brush profile of the current stamp. Currently, the following profiles are supported: gaussian, soft, solidand square. C: Default is gaussian. Q: When queried, it returns a string. stampSpacing / stS float strokesmooth / ssm unicode surfaceConformedBrushVertices / scv bool Enables/disables the the display of the effective brush area as affected vertices. tablet / tab bool Returns true if the tablet device is present, false if it is absent tangentOutline / to bool 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 Applicable only during velocitypainting. 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 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 Specifies the values of the x, y, and z components of the velocity to use when painting the property velocity. Flag can have multiple arguments, passed either as a tuple or a list. whichTool / wst unicode worldRadius / wlR float Derived from mel command maya.cmds.artFluidAttrCtx
Example:
import pymel.core as pm # 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' #