brush node

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.

leafFaceSun (lfcs) double 0.0

how much leaves twist towards the direction defined by the sun direction attribute. For a value of one they will exactly twist towards the sun, while for a value of zero they will ignore the sun 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.

flowerFaceSun (ffcs) double 0.0

how much flowers twist towards the direction defined by the sun direction attribute. For a value of one they will exactly twist towards the sun, while for a value of zero they will ignore the sun direction.

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.