brush node

Go to: Related nodes. Attributes.

                This node contains shading and tube dynamics attributes
                that are used by stroke nodes for Maya Particle Paint.

Node name	Parents	Classification	MFn type	Compatible function sets
brush	dependNode	brush	kBrush	kBase kNamedObject kDependencyNode kBrush

Related nodes

strokeGlobals, stroke

Attributes (371)

Attribute quick index omitted (too many attributes to show them all).

Long name (short name) Type Default Flags

outBrush (obr) dynBrush NULL

output brush data for use by stroke nodes

time (tim) time 0film

time value for animated effects

globalScale (gsc) double 1.0

Scales all effects

depth (dep) bool false

whether or not to use zbuffered occusion

modifyDepth (mdp) bool true

whether or not to write into the zbuffer( only if depth is ON )

modifyColor (mdc) bool true

whether or not to write into r,g,b

modifyAlpha (mda) bool true

whether or not to write into the alpha channel

illuminated (ill) bool false

Use lights for shading.

castShadows (csd) bool false

make brush strokes appear in depth map shadows

lightingBasedWidth (lbw) double 0.0

The tube width is scaled by the diffuse light intensity. Brighter regions will be thinner. Shadowed and dark regions will have full width tubes. Using negative values can have the reverse effect. The lighting used is a diffuse illumination that is relative to the local surface normal painted on by the stroke.

branches (brc) bool false

split tubes into branches

twigs (twg) bool false

create twigs as offshoots on branches

buds (bud) bool false

create bud swellings at the tips of branches and twigs

leaves (lvs) bool false

create leaves on branches and twigs

flowers (flw) bool false

create flower petals on branches, twigs and buds

brushType (brt) enum 0

Method used for brushstamp rendering 0 - Paint Brush 1 - Smear Brush 2 - Blur Brush 3 - Erasor Brush 4 - Thin Line Brush 5 - Triangle Mesh Tube

brushWidth (bwd) double 0.05

the worldspace width of the brushstroke

screenspaceWidth (spw) bool false

whether or not to make the line width constant for different depths from the view

distanceScaling (dsl) double 0.0

This controls the amount that the distance from the eye affects the tube width when screenSpace width is enabled. At a value of 0.0 the width is constant while at a value of 1.0 it behaves as if screenspace width is OFF.

minPixelWidth (mpw) double 0.0

When screenspace width is enabled this controls the smallest width a stroke can be in pixels. It is useful for toon lines when one wishes to avoid very thin lines.

maxPixelWidth (mxp) double 1000.0

When screenspace width is enabled this controls the largest width a stroke can be in pixels. It is useful for toon lines when one wishes to avoid very fat lines.

stampDensity (sdn) double 8.0

the spacing of stamps relative to brush width

softness (sft) double 0.2

control for brush edge blurring

edgeAntialias (eaa) bool true

EdgeAntialias determines whether or not to antialias brushstroke edges. Note that this does not affect paint or render speed and should be left on unless hard jagged edges are desired.

edgeClip (ecl) bool false

EdgeClip allows one to make 3D strokes render as if they are painted directly onto a surface's texture. The edgeClipDepth attribute controls how far in front of a surface the stroke can be before it becomes invisible. Thus 3D strokes that sit close to an objects surface can be seen if the surface is behind them, but not if the surface edge is in profile.

edgeClipDepth (ecd) double 0.1

EdgeClipDepth controls how close an object behind a stroke must be in order for the stroke to be visible.

occlusionWidthScale (ows) bool false

OcclusionWidthScale scale stamp size down based on overlap by forground objects. The full stamp is always drawn, avoiding antialias problems where occluded by non-paint effects forground objects. The size of the stamp is reduced to zero (and thus hidden) when the entire stamp is occluded.

blurIntensity (bin) integer 4

number of iterations of the blur filter each stamp

color1 (cl1) float3

input color

color1R (c1r) float 0.0

color1 Red value

color1G (c1g) float 0.0

color1 Green value

color1B (c1b) float 0.0

color1 Blue value

color2 (cl2) float3

input color for tube ends

color2R (c2r) float 1.0

color2 Red value

color2G (c2g) float 1.0

color2 Green value

color2B (c2b) float 1.0

color2 Blue value

transparency1 (tn1) float3

input color transparency

transparency1R (t1r) float 0.0

transparency1 Red value

transparency1G (t1g) float 0.0

transparency1 Green value

transparency1B (t1b) float 0.0

transparency1 Blue value

transparency2 (tn2) float3

input color transparency for tube end

transparency2R (t2r) float 0.0

transparency2 Red value

transparency2G (t2g) float 0.0

transparency2 Green value

transparency2B (t2b) float 0.0

transparency2 Blue value

incandescence1 (in1) float3

input incandescence (color addition)

incandescence1R (i1r) float 0.0

incandescence1 Red value

incandescence1G (i1g) float 0.0

incandescence1 Green value

incandescence1B (i1b) float 0.0

incandescence1 Blue value

incandescence2 (in2) float3

input incandescence for tube end

incandescence2R (i2r) float 0.0

incandescence2 Red value

incandescence2G (i2g) float 0.0

incandescence2 Green value

incandescence2B (i2b) float 0.0

incandescence2 Blue value

specularColor (spc) float3

input color for specular highlights

specularColorR (spr) float 1.0

specular Red value

specularColorG (spg) float 1.0

specular Green value

specularColorB (spb) float 1.0

specular Blue value

specular (spe) double 0.0

intensity of specular highlights

specularPower (spp) double 10.0

focus or size of specular highlights

translucence (trn) double 0.2

blend factor between translucent and lambertian shading

glow (glw) double 0.0

intensity of glow effect

glowColor (glc) float3

input color for glow

glowColorR (glr) float 0.5

glow Red value

glowColorG (glg) float 0.5

glow Green value

glowColorB (glb) float 0.5

glow Blue value

glowSpread (gls) double 3.0

amount to scale brush size by for glow stamp

shaderGlow (sgl) double 0.0

intensity of post render shaderglow effect

hueRand (chr) double 0.0

random deviation in hue of tubes

satRand (csr) double 0.0

random deviation in color saturation of tubes

valRand (cvr) double 0.0

random deviation in brighness value of tubes

rootFade (rfd) double 0.0

distance from base of tube at which it becomes fully visible

tipFade (tfd) double 0.0

distance from end of tube at which it becomes fully visible

fakeShadow (fks) enum 0

create 3D surface shadow simulation or simple 2D dropshadow 0 - none 1 - 2D offset shadow 2 - 3D simulated cast shadow

shadowOffset (sof) double 0.5

2D drop shadow offset

shadowDiffusion (sdf) double 0.1

the softness of fake shadows

shadowTransparency (stn) double 0.8

visibility of simulated shadows

backShadow (bks) double 0.0

shadow strokes on awayfacing side of parent surface

brightnessRand (brn) double 0.0

randomization of tube brightness

centerShadow (cns) double 0.0

shadow from brushstamp center

depthShadowType (dpt) enum 0

define shadow as depth from surface, or distance from path 0 - Surface Depth 1 - Path Dist

depthShadow (dpl) double 0.0

darkness of the depth shadow

depthShadowDepth (dps) double 0.0

shadow offset distance

realLights (rll) bool false

illuminate using light nodes

lightDirection (ldr) double3

direction of simple directional lightsource

lightDirectionX (ldx) double 0.5

X value for light direction

lightDirectionY (ldy) double 0.5

Y value for light direction

lightDirectionZ (ldz) double -0.5

Z value for light direction

gapSize (gsz) double 0.0

size of gaps relative to gapSpacing (1 = all hole)

gapSpacing (gsp) double 1.0

separation of gaps along stroke

gapRand (grn) double 0.0

random offset along tubes for gaps

flowSpeed (fws) double 0.0

speed of flow down brush path: affects gaps, twist and texture

textureFlow (tfl) bool true

move texture with flow defined by flowspeed. In general this is best turned off for growth animations, but is useful when one want a texture, particularily a displacement, to flow down the tubes.

timeClip (tcl) bool false

bound tubes with a start and end time( tube treated as a flow )

strokeTime (srm) bool false

add in the path steps to time used for clipping.

startTime (sti) double 0.0

start time bound for tubes and path

endTime (eti) double 1000.0

end time bound for tubes and path

tubes (tub) bool false

generate dynamic tubes along path

creationScript (csc) string NULL

the name of a mel script to use for tube generation

runtimeScript (rsc) string NULL

the name of a mel script called at each step in the simulation to shape the flow and behavior of tubes

tubeCompletion (tcm) bool true

run dynamic simulation until all tubes are at their final length

tubesPerStep (tps) double 0.5

number of tubes generated for every new point along path

tubeRand (trd) double 1.0

randomization of tube generation

startTubes (stb) integer 0

number of tubes created at beginning of path

lengthMax (lnx) double 1.0

max tube length

lengthMin (lnn) double 0.0

min tube length

segments (sgm) integer 10

number of segments in full length tubes

tubeWidth1 (tw1) double 0.01

worldspace start width of tubes

tubeWidth2 (tw2) double 0.01

worldspace end width of tubes

widthRand (wdr) double 0.0

Randomization of tube start widths

widthBias (wdb) double 0.0

the proportion of large to small tubes

lengthFlex (lfx) double 0.0

the degree to which forces can stretch the tubes

segmentLengthBias (sgb) double 0.0

the amount that segment lengths are smaller towards root or tip of tube

segmentWidthBias (swb) double 0.0

the amount that segment lengths are proportional to the tube width

tubeDirection (tdr) enum 0

primary axis for generation of tubes ( direction if elevation = 0.0) 0 - along surface or defined normal 1 - along path of stroke

elevationMin (elm) double 0.2

min elevation of tubes above stroke

elevationMax (elx) double 0.5

max elevation of tubes above stroke

azimuthMin (azn) double -0.1

min angle of tubes with stroke direction

azimuthMax (azx) double 0.1

max angle of tubes with stroke direction

flatness1 (fl1) double 0.0

flatness of tube at base

flatness2 (fl2) double 0.0

flatness of tube at tip

twist (twi) double 0.0

start twist of tube

twistRate (twr) double 0.0

how much flat tubes twist along length like a streamer

twistRand (twd) double 1.0

randomization of twist when splitting

spiralMin (spm) double 0.0

min amount of spiral about surface normal

spiralMax (spx) double 0.0

max amount of spiral about surface normal

spiralDecay (spd) double 0.0

rate of change in spiral

bend (ben) double 0.0

amount of bend about the axis defined by the current twist.

bendBias (bnb) double 0.0

the relative strength of the bend from root to tip. High values cause a faster bending near the tip.

displacementDelay (ddl) double 0.2

initial ramp up of displacement relative to max tube length

wiggle (wgl) double 0.0

amount of wiggle tangent to stroke surface

wiggleFrequency (wgf) double 3

wavelength for wiggle effect

wiggleOffset (wgo) double 0.0

translation of wiggle down tube path

curl (crl) double 0.0

amount of curl about tube direction

curlFrequency (crf) double 1

rate of curl

curlOffset (cro) double 0.0

translation of curl down tube

noise (noi) double 0.0

amount of perlin noise offset in space

noiseFrequency (nof) double 0.2

scale of the noise offset along tube

noiseOffset (noo) double 0.0

translation of noise down tube

splitMaxDepth (smd) double 2.0

the number of splits along a given tube

splitRand (srd) double 0.0

the randomness of the offset of split events along the tube

splitAngle (spa) double 30.0

the angle with the new branches with respect to the base tube

splitSizeDecay (ssd) double 0.7

tubes are scaled by this factor at each split

splitBias (slb) double 0.0

the degree to which splits happen nearer the tube base or tip

splitTwist (slt) double 0.5

the amount of twist every branch event

startBranches (sbr) double 0

the initial number of child branches at tube origin

numBranches (nbr) integer 2

the number of child branches per split

branchDropout (bdr) double 0.0

the proportion of branches that are pruned

middleBranch (mbr) bool false

whether or not to keep the main trunk at split points

minSize (mms) double 0.0001

cutoff size when tube size is diminishing

pathFollow (pfl) double 0.0

the amount tubes shapes match the shape of the path

pathAttract (pat) double 0.0

the path acts as a force

curveFollow (cfw) double 0.0

degree to which stroke shape matches input curve

curveAttract (cva) double 0.0

input curve acts as a force

curveMaxDist (cmd) double 0.0

max distance for influence of curves (0.0 = infinite)

uniformForce (ufr) double3

worldspace directional force

uniformForceX (ufx) double 0.0

worldspace directional force X value

uniformForceY (ufy) double 0.0

worldspace directional force Y value

uniformForceZ (ufz) double 0.0

worldspace directional force Z value

turbulenceType (trt) enum 0

use no turbulence, path relative, or worldspace turbulence 0 - Off 1 - Turbulence is a force in path space 2 - Turbulence is a force in worldspace 3 - Turbulence applied as localspace offset to tube 4 - Turbulence applied as worldspace offset to tube

turbulenceInterpolation (tin) enum 0

Interpolation method for values on the turbulence grid 0 - Linear interpolation 1 - Smooth interpolation(quadratic) over time only 2 - Smooth interpolation(quadratic) over both time and space

turbulence (tur) double 0.2

level of animated wind turbulence that seamlessly loops in both space and time

turbulenceFrequency (trf) double 0.2

this scales the turbulence spacially

turbulenceSpeed (trs) double 0.5

this scales the time value used for the turbulence function

turbulenceOffset (tro) double3

xyz translation of turbulence

turbulenceOffsetX (trx) double 0.0

turbulence translation in X

turbulenceOffsetY (try) double 0.0

turbulence translation in Y

turbulenceOffsetZ (trz) double 0.0

turbulence translation in Z

random (ran) double 0.0

local force with random direction and intensity

gravity (grv) double 0.0

vertical worldspace force

momentum (mmt) double 1.0

The particle velocity is scaled by this factor at each simulation step.

deflection (def) bool false

Fake surface collision using repulsive force

deflectionMin (dfm) double 0.0

offset for where the surface is presumed to be

deflectionMax (dfx) double 0.3

distance from surface at which deflection field fades to zero

twigsInCluster (tic) integer 1

number of twigs created at life end

twigDropout (tdp) double 0.0

rate of omitted twigs

twigAngle1 (ta1) double 90.0

start angle of twig with branch

twigAngle2 (ta2) double 80.0

end angle of twig with branch

twigTwist (ttw) double 0.0

rate of twist about branch per twig

twigLength (twl) double 0.5

length of twig stroke

twigStart (tst) double 0.5

point along branch where twigs start

numTwigClusters (ntc) double 4

total number of twig sprouts created between twig Start and branch tip

twigBaseWidth (twb) double 0.4

start size for twig stroke

twigTipWidth (twt) double 0.2

end size for twig stroke

twigStiffness (tgs) double 0.5

how much twigs are affected by forces such as turbulence, gravity, random and spiral. At a value of one these brush forces will not have an effect.

branchAfterTwigs (bat) bool false

put branches on twigs rather than twigs on branches

leavesInCluster (lic) integer 1

number of leaves created at each sprout

leafLocation (llo) enum 0

This determines which components may sprout leaves. 0 - On All 1 - On Secondary Branches Only 2 - On Twigs Only

leafDropout (ldp) double 0.0

rate of omitted leaves

leafAngle1 (ll1) double 75.0

angle of leaf with branch at leafStart

leafAngle2 (ll2) double 25.0

angle of leaf with branch at branch tip

leafTwist (ltw) double 0.0

rate of twist about branch per leaf

leafBend (lbn) double 0.0

amount of bend about the axis defined by the current twist of the leaf. This can be used to make a leaf roll up, or provide better shaping of the general curl of the leaf.

leafCurl (lcl) compound n/a

amount of curl away from the primary axis of the leaf. This is perpendicular to the leaf bend direction. This can both provide a more natural leaf shape and help create a more rounded shading when the flatness is 1.0. The left side of the ramp represents curl at the leaf base and the right side is the leaf tip.

leafCurl_Position (lclp) float 0.0

Position of ramp value on normalized 0-1 scale

leafCurl_FloatValue (lclfv) float 0.0

Ramp value at the sibling position

leafCurl_Interp (lcli) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

leafTwirl (ltwl) double 0.0

amount of rotation or twist of the leaf about its primary axis. This can be used to make leaves better face a certain direction.

leafSegments (lsg) integer 5

number of segments in leaf stroke

leafStart (lst) double .5

point along branch where leaves start

numLeafClusters (nlc) double 3

total number of leaf sprouts created between Leaf Start and branch tip

leafFlatness (lft) double 1.0

flatness to use for the leaf stroke

leafLength (lln) double 0.3

length scale for leaf stroke

leafBaseWidth (leb) double 0.15

width at base of leaf stroke

leafTipWidth (let) double 0.05

width at tip of leaf stroke

leafSizeDecay (lsd) double 0.7

scale factor for leaves at branch tip

leafTranslucence (ltr) double 0.7

blend factor between translucent and lambertian shading for leaves

leafSpecular (lsp) double 0.0

intensity of specular highlights on leaves

terminalLeaf (tml) bool false

whether or not to add a single leaf at the very end of the branch

leafColor1 (lc1) float3

start color for leaf

leafColor1R (lr1) float 0.2

leaf start Red value

leafColor1G (lg1) float 0.6

leaf start Green value

leafColor1B (lb1) float 0.3

leaf start Blue value

leafColor2 (lc2) float3

start color for leaf

leafColor2R (lr2) float 0.4

leaf end Red value

leafColor2G (lg2) float 0.6

leaf end Green value

leafColor2B (lb2) float 0.3

leaf end Blue value

leafHueRand (lhr) double 0.0

random deviation in hue of leaves

leafSatRand (lsr) double 0.0

random deviation in color saturation of leaves

leafValRand (lvr) double 0.0

random deviation in brighness value of leaves

leafUseBranchTex (lub) bool true

whether or not to use the main texture applied to branches

leafImage (lim) string NULL

the name of an image file to use for leaf strokes

leafStiffness (lfs) double 0.5

how much leaves are affected by forces such as turbulence, gravity, random and spiral. At a value of one these brush forces will not have an effect.

budSize (bds) double 0.03

size of bud swelling at branch tip

budColor (bcr) float3

color of bud at branch tip

budColorR (bur) float 0.4

bud Red value

budColorG (bug) float 0.8

bud Green value

budColorB (bub) float 0.2

bud Blue value

petalsInFlower (pif) integer 1

number of flowers created at life end

flowerLocation (flc) enum 0

This determines which components may sprout flowers. 0 - On All 1 - On Secondary Branches Only 2 - On Twigs Only

petalDropout (pdp) double 0.0

rate of omitted flowers

flowerAngle1 (fw1) double 75.0

angle of flower with branch at flowerStart

flowerAngle2 (fw2) double 25.0

angle of flower with branch at branch tip

flowerTwist (ftw) double 0.23

rate of twist about branch per flower

petalBend (pbn) double 0.0

amount of bend about the axis defined by the current twist of the petal. This can be used to make a petal curl up, or provide better shaping of the petal.

petalCurl (pcl) compound n/a

amount of curl away from the primary axis of the petal. This is perpendicular to the petal bend direction. This can provide a more natural petal shape and help avoid interpenetration with neighboring petals. The left side of the ramp represents curl at the petal base and the right side is the petal tip.

petalCurl_Position (pclp) float 0.0

Position of ramp value on normalized 0-1 scale

petalCurl_FloatValue (pclfv) float 0.0

Ramp value at the sibling position

petalCurl_Interp (pcli) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

petalTwirl (lpwl) double 0.0

amount of rotation or twist of the petal about its primary axis. This can be used to make petals better face a certain direction, or to twist a bit so as not to self intersect when forming a flower.

petalSegments (psg) integer 5

number of segments in flower stroke

flowerStart (fst) double 1

point along branch where flowers start

numFlowers (nfl) double 10

total number of petal groups created between flower Start and branch tip

petalFlatness (pft) double 1.0

flatness to use for the flower stroke

petalLength (pln) double 0.2

length scale for flower stroke

petalBaseWidth (ptb) double 0.05

width at base of flower petals

petalTipWidth (ptt) double 0.1

width at tip of flower petals

flowerSizeDecay (fsd) double 0.7

scale factor for flowers at branch tip

flowerTranslucence (ftr) double 0.7

blend factor between translucent and lambertian shading for flowers

flowerSpecular (fsp) double 0.0

intensity of specular highlights on flowers

petalColor1 (pc1) float3

start color for flower

petalColor1R (pr1) float 0.8

flower start Red value

petalColor1G (pg1) float 0.2

flower start Green value

petalColor1B (pb1) float 0.1

flower start Blue value

petalColor2 (pc2) float3

start color for flower

petalColor2R (pr2) float 1.0

flower end Red value

petalColor2G (pg2) float 1.0

flower end Green value

petalColor2B (pb2) float 1.0

flower end Blue value

flowerHueRand (fhr) double 0.0

random deviation in hue of flowers

flowerSatRand (fsr) double 0.0

random deviation in color saturation of flowers

flowerValRand (fvr) double 0.0

random deviation in brightness value of flowers

flowerUseBranchTex (fub) bool true

whether or not to use the main texture applied to branches

flowerImage (fim) string NULL

the name of an image file to use for flower petals

flowerStiffness (fls) double 0.5

how much flowers are affected by forces such as turbulence, gravity, random and spiral. At a value of one these brush forces will not have an effect.

simplifyMethod (smp) enum 0

method used to simplify the wireframe draw in conjunction with the stroke display quality setting 0 - stroke quality only affects the number of tubes 1 - stroke quality only affects the number of segments along tubes 2 - stroke quality affects the number of tubes and the number of segments

colorLengthMap (clm) enum 0

define the method used to map against tube length 0 - Length Relative 1 - Max Length Relative

transpLengthMap (tlm) enum 0

define the method used to map against tube length 0 - Length Relative 1 - Max Length Relative

incandLengthMap (ilm) enum 0

define the method used to map against tube length 0 - Length Relative 1 - Max Length Relative

widthLengthMap (wlm) enum 0

define the method used to map against tube length 0 - Length Relative 1 - Max Length Relative

splitLengthMap (spl) enum 0

define the method used to map against tube length 0 - Length Relative 1 - Max Length Relative

mapColor (mcl) bool false

Texture color using the current texture

mapOpacity (mop) bool false

Texture opacity using the current texture

mapDisplacement (mds) bool false

Texture displacement using the current texture

textureType (txt) enum 0

define the current texture method 0 - Checker 1 - U Ramp 2 - V Ramp 3 - Fractal 4 - File

mapMethod (mmd) enum 0

0 - the texture is fit to the view 1 - the mapping is in eyespace but scaled and offset based on the start of the brushstroke or tube 2 - the mapping is in worldspace but always centered on the tube, such that there never a visible seam. 3 - the texture is fully mapped in 3D around the tube, with a seam that is visible from some views. The texture appears correct when the viewpoint is animated.

texColorScale (tcs) double 1.0

The amount the texture's color is multiplied by the non-textured color.

texColorOffset (tco) double 0.0

The amount the texture's color is added into the output color

texOpacityScale (tos) double 1.0

The amount the texture's alpha multiplies the opacity.

texOpacityOffset (too) double 0.0

The amount the texture's alpha is added into the output opacity

displacementScale (dsc) double 1.0

The amount the texture's alpha is used to scale ( or multiply ) the tube width. Thus this form of displacement is relative to the width of tubes.

displacementOffset (dof) double 0.0

The amount the texture's alpha is added to the tube width. This displacement is independent of tube width, so thin tubes may have more displacement than desired.

bumpIntensity (bmi) double 1.0

The amount of bump added relative to the general displacement. The bump provides needed detail when displaced triangles are large relative to a pixel. Note that bump mapping requires both that displacement is on and perPixel mesh shading is used. If one wishes to have only the bump with no displacement, then make the displacement scale and offset zero.

bumpBlur (bbl) double 0.5

This scales the separation of the extra texture samples used in computing the bump map. It has the effect of making the bump smoother and less detailed. If it is too low, however, the bump may appear broken up and may jitter in animations. A value of 1.0 avoids most of these jitter or aliasing problems, but results in too smooth a bump for distant or oblique strokes. In practice a value of 0.5 can be a good compromise.

luminanceIsDisplacement (lid) bool true

In particular one may wish to use the color from file textures for displacement instead of the image alpha. This also frees the alpha for use in transparency. This uses the brighness of the color for displacement.

texColor1 (tc1) float3

color for min texture values

texColor1R (x1r) float 1.0

texColor1 Red value

texColor1G (x1g) float 1.0

texColor1 Green value

texColor1B (x1b) float 1.0

texColor1 Blue value

texColor2 (tc2) float3

color for min texture values

texColor2R (x2r) float 0.0

texColor2 Red value

texColor2G (x2g) float 0.0

texColor2 Green value

texColor2B (x2b) float 0.0

texColor2 Blue value

texAlpha1 (al1) double 1.0

Alpha (opacity) for max texture values.

texAlpha2 (al2) double 0.0

Alpha (opacity) for min texture values.

texUniformity (txu) double 0.5

Degree to which Uvalue along stroke is in worldspace

fringeRemoval (frm) bool true

Correct for dark fringes along file texture alpha boundaries. The file texture's color is premultiplied by 1/alpha.

repeatU (rpu) double 1.0

repeat of texture in U dimension

repeatV (rpv) double 1.0

repeat of texture in V dimension

offsetU (ofu) double 0.0

translate of texture along U

offsetV (ofv) double 0.0

translate of texture along V

blurMult (bmt) double 1.0

blurring of texture(needed for antialiasing )

smear (smr) double 0.1

scale of 2Dnoise used for smear effect

smearU (sru) double 0.0

smear offset intensity in U

smearV (srv) double 0.0

smear offset intensity in V

imageName (imn) string NULL

the name of an image file to use for file texture type

useFrameExtension (ufe) bool false

When Use Frame Extension is on, the frame number in the file name will be replaced with the number specified in the Frame Extension attribute. Use this when you want to animate the texture.

frameExtension (fe) integer 1

Frame Extension replaces the frame extension number in the file name (if there is one). This attribute is only meaningful if Use FrameExtension is turned on.

Keyframe this attribute when you want to use a sequence of files as a file texture.

fractalRatio (fra) double 0.7

the roughness of the fractal

fractalAmplitude (fam) double 1.0

the intensity or contrast of the fractal

fractalThreshold (fth) double 0.0

a cutoff value

multiStreaks (mst) integer 0

Multi Streaks is the number of added tubes. These tubes will share the same shading as the base tube they are derived from. They are created at render time and are simple duplicates, and thus do not take up any shape computation. This allows one to have a great number of tubes and yet render them in a reasonable amount of time.

multiStreakSpread1 (ms1) double 0.2

the maximum offset for added tubes relative to the brush width at the tube base

multiStreakSpread2 (ms2) double 0.2

the maximum offset for added tubes relative to the brush width at the tube tip

multiStreakDiffuseRand (msdr) double 0.0

a diffuse brightness randomization for the added tubes

multiStreakSpecularRand (mssr) double 0.0

a specular brightness randomization for the added tubes

multiStreakLightAll (msla) bool false

a brightness randomization for the added tubes

singleSided (snsd) bool false

toggles backface removal for the mesh brushType making the inside edge of tubes disappear and speeding up the render

tubeSections (tbs) integer 6

the number of points in each cross section used for the mesh brushType

subSegments (ssg) integer 1

the number of cross sections added for each base segment for the mesh brushType

perPixelLighting (ppl) bool false

light each pixel when rendering, as opposed to lighting each vertex and interpolating the result when the mesh brushType is used. This will allows for detailed shadows and specular highlights. Also when displacement mapping is used it will allow a bump mapping of normals within each triangle. Note that if realLights is enabled this can result in significantly slower renders, as the evaluation of Maya lights is slow in the paint effects context.

widthScale (wsc) compound n/a

multiplies the width along the tube determined by the base and tip width. This is useful for creating shapes other than the simple conical tube shape determined by the base and tip widths. The left of the graph is the scale at the base and the right is the scale at the tip.

widthScale_Position (wscp) float 0.0

Position of ramp value on normalized 0-1 scale

widthScale_FloatValue (wscfv) float 0.0

Ramp value at the sibling position

widthScale_Interp (wsci) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

leafWidthScale (lws) compound n/a

multiplies the width along the leaf determined by the leaf base and tip widths. This is useful for creating shapes other than the simple conical tube shape determined by the base and tip widths. The left of the graph is the scale at the base and the right is the scale at the tip.

leafWidthScale_Position (lwsp) float 0.0

Position of ramp value on normalized 0-1 scale

leafWidthScale_FloatValue (lwsfv) float 0.0

Ramp value at the sibling position

leafWidthScale_Interp (lwsi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

petalWidthScale (pws) compound n/a

multiplies the width along the petal determined by the petal base and tip widths. This is useful for creating shapes other than the simple conical tube shape determined by the base and tip widths. The left of the graph is the scale at the base and the right is the scale at the tip.

petalWidthScale_Position (pwsp) float 0.0

Position of ramp value on normalized 0-1 scale

petalWidthScale_FloatValue (pwsfv) float 0.0

Ramp value at the sibling position

petalWidthScale_Interp (pwsi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

twigLengthScale (tls) compound n/a

multiplies the twig lengths from root to tip of the parent branch. The left of the graph is the scale at the base of a tree and the right is the scale at the tip.

twigLengthScale_Position (tlsp) float 0.0

Position of ramp value on normalized 0-1 scale

twigLengthScale_FloatValue (tlsfv) float 0.0

Ramp value at the sibling position

twigLengthScale_Interp (tlsi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

branchThorns (bth) bool false

create thorns or prickles on branch tubes when the mesh brushType is used. This will also show up on normal strokes when tubes = OFF, as the effect is not part of the tubes simulation, but rather a render effect. The thorns are drawn as a single segment using the thinTube method, and project off the triangle mesh along the triangle normals.

twigThorns (tth) bool false

create thorns or prickles on twig tubes when the mesh brushType is used. The thorns are drawn as a single segment using the thinTube method, and project off the triangle mesh along the triangle normals.

leafThorns (lth) bool false

create thorns or prickles on leaf tubes when the mesh brushType is used. The thorns are drawn as a single segment using the thinTube method, and project off the triangle mesh along the triangle normals.

flowerThorns (flt) bool false

create thorns or prickles on flower tubes when the mesh brushType is used. The thorns are drawn as a single segment using the thinTube method, and project off the triangle mesh along the triangle normals.

thornDensity (nth) double 10.0

The general amount of thorns drawn on the mesh.

thornLength (tln) double 0.5

The length (relative to the max tube width) for the thorns.

thornBaseWidth (tbwd) double 0.05

The width (relative to the thorn length) at the base of the thorn.

thornTipWidth (ttwd) double 0.01

The width (relative to the thorn length) at the outer thorn tip.

thornElevation (tel) double 0.6

elevation of the thorns relative to the mesh surface. An elevation of 1.0 is along the mesh normal. An elevation of 0 is along the tube and an elevation of 2 is opposite to this.

thornSpecular (tsp) double 0.4

intensity of specular highlights on thorns

thornBaseColor (tbc) float3

color of thorns at the base

thornBaseColorR (tbcr) float 0.5

Thorn Base Color Red value

thornBaseColorG (tbcg) float 0.5

Thorn Base Color Green value

thornBaseColorB (tbcb) float 0.5

Thorn Base Color Blue value

thornTipColor (ttc) float3

color of thorns at the tip

thornTipColorR (ttcr) float 0.5

Thorn Tip Color Red value

thornTipColorG (ttcg) float 0.5

Thorn Tip Color Green value

thornTipColorB (ttcb) float 0.5

Thorn Tip Color Blue value

environment (env) compound n/a

This defines a spherical reflection environment, where the left of the ramp represents light from the top of the sky, the right is the ground and the middle is the horizon. Currently it only works with the mesh brushtype.

environment_Position (envp) float 0.0

Position of ramp value on normalized 0-1 scale

environment_Color (envc) float3

Ramp color at the sibling position

environment_ColorR (envcr) float 0.0

Ramp red channel value at the sibling position

environment_ColorG (envcg) float 0.0

Ramp green channel value at the sibling position

environment_ColorB (envcb) float 0.0

Ramp blue channel value at the sibling position

environment_Interp (envi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

reflectionRolloff (rro) compound n/a

Reflection Rolloff controls the reflectivity of the environment ramp based on the angle of the surface with the view. The horizontal dimension of the graph represents the brightness of reflections and the horizontal represents the facing angle with the view. Tip: to get a "wet" look (such as wet paint), make the edges more reflective.

reflectionRolloff_Position (rrop) float 0.0

Position of ramp value on normalized 0-1 scale

reflectionRolloff_FloatValue (rrofv) float 0.0

Ramp value at the sibling position

reflectionRolloff_Interp (rroi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

branchReflectivity (brf) double 0.0

intensity of environment reflection on primary branches and twigs. This also applies to strokes when tubes = OFF. Environment reflections only work with the mesh brushtype.

leafReflectivity (lrf) double 0.0

intensity of environment reflection on leaves. Environment reflections only work with the mesh brushtype.

flowerReflectivity (frf) double 0.0

intensity of environment reflection on flowers. Environment reflections only work with the mesh brushtype.

forwardTwist (fwt) bool false

Lock the twist about main branches to always face the current camera. This is useful when setting up billboard style effect where one always wishes the texture to face the view. If the tubes are flat, then the flat side will alway orient towards the camera. With this on, one could texture a simple flat stroke and always have it face the view. For a tree one could create a texture of a tree trunk with rough edges and map to a simple flat ribbon where the ribbon always faces the camera.

leafForwardTwist (lfwt) bool false

Lock the twist about leaves to always face the current camera. This is useful when setting up billboard style effect where one always wishes the texture to face the view. If the leaves are flat, then the flat side will alway orient towards the camera. One could map an image of an entire leafy branch with alpha to a flat leaf and use this toggle to always orient this image towards the view.

petalForwardTwist (lpwt) bool false

Lock the twist about flower petals to always face the current camera. This is useful when setting up billboard style effect where one always wishes the texture to face the view. If the petals are flat, then the flat side will alway orient towards the camera. One could map an image of an apple or rose to a single flat petal, and have this always face the viewpoint.

endCaps (edc) bool false

Add end cap geometry to tubes when using the mesh brushType .

hardEdges (hde) bool false

Make the edges around tubes hard when using the mesh brushType. For example if the tubeSections is 4 then this toggle will make the tube shade as if the 4 sides are flat, rather than trying to simulate a rounded tube. For bends in the direction of the tube( for example due to changes in the widthScale ) the bend angle across a given must be sufficiently large to make the angle hard. The number of segments used can affect whether a given region on the tube become hard edged or not. Note that this parameter adjusts the normals used for shading, and does not alter the shape of the tube.