pymel.core.context.artFluidAttrCtx¶

artFluidAttrCtx(*args, **kwargs)¶

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. 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
	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		unicode
	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		unicode
	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
	Specifies the lower bound for the alpha values. C: Default is 0.0. Q: When queried, it returns a float.
alphaclampupper / acu		float
	Specifies the upper bound for the alpha values. C: Default is 1.0. Q: When queried, it returns a float.
attrSelected / asl		unicode
	Returns a name of the currently selected attribute. Q: When queried, it returns a string.
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
	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		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
	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
	Specifies the lower bound for the values. C: Default is 0.0. Q: When queried, it returns a float.
clampupper / clu		float
	Specifies the upper bound for the values. C: Default is 1.0. Q: When queried, it returns a float.
clear / clr		bool
	Floods all cvs/vertices to the current value.
colorAlphaValue / cl1		float
	The Alpha value of the color.
colorRGBAValue / cl4		float, float, float, float
	The RGBA value of the color.
colorRGBValue / cl3		float, float, float
	The RGB value of the color.
colorRamp / cr		unicode
	Allows a user defined color ramp to be used to map values to colors.
colorfeedback / cf		bool
	Sets on/off the color feedback display. C: Default is FALSE. Q: When queried, it returns a boolean.
colorfeedbackOverride / cfo		bool
	Sets on/off the color feedback override. C: Default is FALSE. Q: When queried, it returns a boolean.
colorrangelower / crl		float
	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
	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		unicode
	Query the name of the fluid on which this context is currently painting. Returns string.
dataTypeIndex / dti		int
	When the selected paintable attribute is a vectorArray, it specifies which field to paint on.
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
	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		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
	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		bool
	Enable or disable dynamic clone mode.
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
	Value of aspect ratio for export
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
	Sets the node filter.
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
	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		unicode
	Value of last recorded command.
lastStampName / lsn		unicode
	Value of the last stamp name.
lowerradius / lr		float
	Sets the lower size of the brush (only apply on tablet).
makeStroke / mst		int
	Stroke point values.
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
	Specifies the maximum value for each attribute. C: Default is 1.0. Q: When queried, it returns a float.
minvalue / miv		float
	Specifies the minimum value for each attribute. C: Default is 0.0. Q: When queried, it returns a float.
name / n		unicode
	If this is a tool command, name the tool appropriately.
objattrArray / oaa		unicode
	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
	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
	An array of paintable nodes. Q: When queried, it returns a string.
paintattrselected / pas		unicode
	An array of selected paintable attributes. Each element of the array is a string with the following information: NodeType.NodeName.AttributeName.
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
	Specifies the operation type used by the Paint Tool. Currently, we support the following paint modes: Paint, Smear, Blur, Eraseand Clone. Default is Paint.
pickColor / pcm		bool
	Set pick color mode on or off
pickValue / pv		bool
	Toggle for picking
playbackCursor / plc		float, float
	Values for the playback cursor.
playbackPressure / plp		float
	Valus for the playback pressure.
preserveclonesource / pcs		bool
	Whether or not to preserve a clone source.
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
	Defines a special color to be used when the value is greater than or equal to the maximum value.
rampMinColor / rmc		float, float, float
	Defines a special color to be used when the value is less than or equal to the minimum value.
record / rec		bool
	Toggle on for recording.
reflection / rn		bool
	Specifies the reflection mode. C: Default is ‘false’. Q: When queried, it returns a boolean.
reflectionaboutorigin / rno		bool
	Toggle on to reflect about the origin
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
	Brush radius on the screen
selectclonesource / scs		bool
	Toggle on to select the clone source
selectedattroper / sao		unicode
	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		bool
	Sets on/off the display of the surface isoparms. C: Default is TRUE. Q: When queried, it returns a boolean.
stampDepth / stD		float
	Depth of the stamps
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
	Specifies the stamp spacing. Default is 1.0.
strokesmooth / ssm		unicode
	Stroke smoothing type name
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
	Accepts a strings describing the name of a MEL procedure that is invoked whenever the tool is turned off. For example, cloth invokes clothPaintToolOffwhen 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		unicode
	Accepts a strings describing the name of a MEL procedure that is invoked whenever the tool is turned on. For example, cloth invokes clothPaintToolOnwhen 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		bool
	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		bool
	Specifies whether the out of range colors should be used. See rampMinColor and rampMaxColor flags for further details.
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
	Specifies the value for each attribute. C: Default is 0.0. Q: When queried, it returns a 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.
whichTool / wst		unicode
	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
	Radius in worldspace Flag can have multiple arguments, passed either as a tuple or a list.

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' #