artPuttyCtx 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.
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-accopacity(-aco)
|
boolean
|
|
|
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
|
|
|
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
|
|
|
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
|
|
|
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)
|
string
|
|
|
Returns a name of the currently selected attribute.
Q: When queried, it returns a string.
|
|
-autosmooth(-asm)
|
boolean
|
|
|
Sets up the auto smoothing option. When the brush
is in the smooth mode, adjusting the strength will adjust how
fast the surfaces is smoothed out.
C: Default is FALSE. Q: When queried, it returns a boolean.
|
|
-beforeStrokeCmd(-bsc)
|
string
|
|
|
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
|
|
-brushStrength(-bs)
|
float
|
|
|
Sets the strength of the brush. Brush strength is supported
by the pinch and slide brushes. In pinch mode, adjusting the strength
will adjust how quickly the surface converges on the brush
center. In slide mode, the strength scales the motion of the brush.
C: Default is 1.0. Q: When queried, it returns a float.
|
|
-brushalignment(-bra)
|
boolean
|
|
|
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
|
|
|
Specifies if the brush additional feedback should
be drawn.
C: Default is TRUE. Q: When queried, it returns a boolean.
|
|
-clamp(-cl)
|
string
|
|
|
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)
|
|
|
|
Floods all cvs/vertices to the current value.
|
|
-collapsecvtol(-clc)
|
float
|
|
|
Specifies the tolerance for the collapse cv detection.
C: Default is 0.005 cm. Q: When queried, it returns a float.
|
|
-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)
|
string
|
|
|
Allows a user defined color ramp to be used to map values to colors.
|
|
-colorfeedback(-cf)
|
boolean
|
|
|
Sets on/off the color feedback display.
C: Default is FALSE. Q: When queried, it returns a boolean.
|
|
-colorfeedbackOverride(-cfo)
|
boolean
|
|
|
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.
|
|
-dataTypeIndex(-dti)
|
int
|
|
|
When the selected paintable attribute is a vectorArray,
it specifies which field to paint on.
|
|
-disablelighting(-dl)
|
boolean
|
|
|
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.
|
|
-dispdecr(-dde)
|
|
|
|
Decreases a maximum displacement by 10%.
|
|
-dispincr(-din)
|
|
|
|
Increases a maximum displacement by 10%.
|
|
-dragSlider(-dsl)
|
string
|
|
|
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
|
|
|
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
|
|
|
Enable or disable dynamic clone mode.
|
|
-erasesrfupd(-eut)
|
boolean
|
|
|
Toggles the update for the erase surface
|
|
-exists(-ex)
|
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
-expandfilename(-eef)
|
boolean
|
|
|
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)
|
string
|
|
|
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
|
|
|
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)
|
string
|
|
|
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)
|
|
|
|
-history(-ch)
|
boolean
|
|
|
If this is a tool command, turn the construction history on
for the tool in question.
|
|
-image1(-i1)
|
string
|
|
|
First of three possible icons representing the tool
associated with the context.
|
|
-image2(-i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
-image3(-i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
-importfileload(-ifl)
|
string
|
|
|
Load the attribute map a specified file.
|
|
-importfilemode(-ifm)
|
string
|
|
|
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
|
|
|
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
|
|
|
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.
|
|
-invertrefvector(-irv)
|
boolean
|
|
|
Sets the invert of the reference vector option when
the reflection is ON. If it is true, the reference vector
for the reflected stroke is negated with respect to the original
one.
C: Default is FALSE. Q: When queried, it returns a boolean.
|
|
-lastRecorderCmd(-lrc)
|
string
|
|
|
Value of last recorded command.
|
|
-lastStampName(-lsn)
|
string
|
|
|
Value of the last stamp name.
|
|
-lowerradius(-lr)
|
float
|
|
|
Sets the lower size of the brush (only apply on tablet).
|
|
-makeStroke(-mst)
|
uint
|
|
|
-mappressure(-mp)
|
string
|
|
|
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.
|
|
-maxdisp(-md)
|
float
|
|
|
Defines a maximum displacement
( maxDisp in [0.0..5.0] ).
C: Default is 1.0. Q: When queried, it returns a float.
|
|
-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.
|
|
-mouldtypehead(-mth)
|
string
|
|
|
Type of type mould to use
|
|
-mouldtypemouse(-mtm)
|
string
|
|
|
Specifies the putty operations/mode ("push" - pushes CVs
along the given direction (see refvector flag), "pull" - pulls
CVs along the specified direction, "smooth" - smooths the sculpt,
"erase" - erases the paint).
C: Default is "push". Q: When queried, it returns a string.
|
|
-mouldtypetail(-mtt)
|
string
|
|
|
Type of eraser mould to use
|
|
-name(-n)
|
string
|
|
|
If this is a tool command, name the tool appropriately.
|
|
-objattrArray(-oaa)
|
string
|
|
|
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)
|
boolean
|
|
|
Specifies if the brush should be drawn.
C: Default is TRUE. Q: When queried, it returns a boolean.
|
|
-outwhilepaint(-owp)
|
boolean
|
|
|
Specifies if the brush outline should be drawn
while painting.
C: Default is FALSE. Q: When queried, it returns a boolean.
|
|
-paintNodeArray(-pna)
|
string
|
|
|
An array of paintable nodes.
Q: When queried, it returns a string.
|
|
-paintattrselected(-pas)
|
string
|
|
|
An array of selected paintable attributes.
Each element of the array is a string with the
following information:
NodeType.NodeName.AttributeName.
|
|
-paintmode(-pm)
|
string
|
|
|
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
|
|
|
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
|
|
|
Set pick color mode on or off
|
|
-pickValue(-pv)
|
|
|
|
-playbackCursor(-plc)
|
float float
|
|
|
Values for the playback cursor.
|
|
-playbackPressure(-plp)
|
float
|
|
|
Valus for the playback pressure.
|
|
-polecv(-pcv)
|
boolean
|
|
|
Pull all the pole CVs to the same position.
|
|
-preserveclonesource(-pcs)
|
boolean
|
|
|
Whether or not to preserve a clone source.
|
|
-profileShapeFile(-psf)
|
string
|
|
|
Passes a name of the image file for the stamp shape
profile.
|
|
-projective(-prm)
|
boolean
|
|
|
Specifies the projective paint mode.
C: Default is 'false'. Q: When queried, it returns a boolean.
|
|
-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)
|
boolean
|
|
|
-reflection(-rn)
|
boolean
|
|
|
Specifies the reflection mode.
C: Default is 'false'. Q: When queried, it returns a boolean.
|
|
-reflectionaboutorigin(-rno)
|
boolean
|
|
|
Toggle on to reflect about the origin
|
|
-reflectionaxis(-ra)
|
string
|
|
|
Specifies the reflection axis. There are three
possibilities: "x", "y" and "z".
C: Default is "x". Q: When queried, it returns a string.
|
|
-refsurface(-rs)
|
boolean
|
|
|
Sets on/off the update of the reference surface.
If it is true the reference surface is automatically updated
on the per stroke bases. If it is false, the user has to update
the reference surface explicitly by pressing the update button
(see updaterefsrf).
C: Default is TRUE. Q: When queried, it returns a boolean.
|
|
-refvector(-rv)
|
string
|
|
|
Specifies the direction of the push/pull operation
("normal" - sculpt along normals, "firstnormal" - sculpt along
the first normal of the stroke, "view" - sculpt along the view
direction, "xaxis", "yaxis", "zaxis" - sculpt along a given
axis directions, "uisoparm", "visoparm" - sculpt along U or V
isoparametric lines), "uvvector" - sculpt along an arbitrary
vector in UV space.
C: Default is "normal". Q: When queried, it returns a string.
|
|
-refvectoru(-rvu)
|
float
|
|
|
Specifies the U component of the UV vector to be used
when -refVector is set to "uvvector".
|
|
-refvectorv(-rvv)
|
float
|
|
|
Specifies the V component of the UV vector to be used
when -refVector is set to "uvvector".
|
|
-screenRadius(-scR)
|
float
|
|
|
Brush radius on the screen
|
|
-selectclonesource(-scs)
|
boolean
|
|
|
Toggle on to select the clone source
|
|
-selectedattroper(-sao)
|
string
|
|
|
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
|
|
|
Sets on/off the display of the surface isoparms.
C: Default is TRUE. Q: When queried, it returns a boolean.
|
|
-smoothiters(-si)
|
int
|
|
|
Sets the quality of the smoothing operation (number of
iterations).
C: Default is 3. Q: When queried, it returns an int.
|
|
-stampDepth(-stD)
|
float
|
|
|
-stampProfile(-stP)
|
string
|
|
|
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
|
|
|
Specifies the stamp spacing. Default is 1.0.
|
|
-stitchcorner(-stc)
|
boolean
|
|
|
Sets on/off the stitching corner mode
C: Default is "off". Q: When queried, it returns a boolean.
|
|
-stitchedgeflood(-sef)
|
|
|
|
Triggers postprocessing stitching edge procedure.
|
|
-stitchtype(-stt)
|
string
|
|
|
Sets on/off the stitching mode ( "off" - stitching
is turned off, "position" - position stitching is done without
taking care about the tangent continuity C0, "tan" - C1
continuity is preserved).
C: Default is "position". Q: When queried, it returns a string.
|
|
-strokesmooth(-ssm)
|
string
|
|
|
Stroke smoothing type name
|
|
-surfaceConformedBrushVertices(-scv)
|
boolean
|
|
|
Enables/disables the the display of the effective brush area
as affected vertices.
|
|
-tablet(-tab)
|
|
|
|
Returns true if the tablet device is present, false if it is absent
|
|
-tangentOutline(-to)
|
boolean
|
|
|
Enables/disables the display of the brush circle tangent to
the surface.
|
|
-toolOffProc(-tfp)
|
string
|
|
|
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
|
|
|
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.
|
|
-updateerasesrf(-ues)
|
|
|
|
Updates the erase surface.
|
|
-updaterefsrf(-urs)
|
|
|
|
Updates the reference surface.
|
|
-useColorRamp(-ucr)
|
boolean
|
|
|
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
|
|
|
Specifies whether the out of range colors should be used. See rampMinColor
and rampMaxColor flags for further details.
|
|
-usepressure(-up)
|
boolean
|
|
|
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.
|
|
-whichTool(-wst)
|
string
|
|
|
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
|
|
|