This node is created
when you create a Paint Effects or toon line
modifier (
Paint Effects > Create Modifier;
Toon > Create Modifier).
The following lineModifier
attributes are available in the Attribute Editor.
Line Modifier Attributes
- Shape
-
Determines the shape
of the line modifier. There will be no effect outside the bounds
of the selected shape. The Dropoff graph
attribute is defined relative to the shape, such that the right edge
of the dropoff is the outer edge of the shape, and the left is the
shape’s center.
- Width Scale
-
Multiplies the current
line width. A value of 1.0 will have no effect and a value of zero
will scale the width to zero.
- Width Offset
-
Adds on to the current
line width. A value of 0.0 will have no effect and a value of 1.0
will increase the width by one.
- Opacity Scale
-
Multiplies the current
line opacity. A value of 1.0 will have no effect and a value of
zero will scale the opacity to zero.
- Opacity Offset
-
Adds on to the current
line opacity. A value of 0.0 will have no effect and a value of
1.0 will make the lines fully opaque.
- Surface Offset
-
Adds on to the current
line surface offset. A value of 0.0 will have no effect and a value
of 1.0 will increase the offset by 1.0. Negative values will clamp
on when an offset of 0 is achieved.
- Line Extend
-
Adds on to the current
line extend. A value of 0.0 will have no effect and a value of 1.0
will increase the extend by 1.0. Negative values will clamp when
an extend of 0 is achieved.
- Modify Color
-
If this option is turned
on the color value is blended with the line color based on the dropoff value.
- Color
-
If Modify
Color is turned on, then this color is blended into the
local line color based on the dropoff value.
- Dropoff
-
Determines the range
of effect within the bounds of the modifier. If the dropoff is set
to a constant value of 1.0 (horizontal line) then lines will be
uniformly modified inside the bounds of the dropoff shape, with
a hard transition at the shape edge. If the right edge of the dropoff
is instead ramped down to zero the transition will be gradual, with
no modulation at the shape edge, and with increasing modulation
towards its center. The dropoff graph attribute is defined relative
to the shape, such that the right edge of the dropoff is the outer
edge of the shape, and the left is the shape’s center.
- Dropoff Noise
-
Modulates the dropoff
value with a 3D noise. It can provide variation for the parameters
being modulated. For example the tube width can be randomized or
wiggled in a noisy fashion using this attribute.
- Noise Frequency
-
Controls how detailed
the Dropoff Noise is. Lower values
result in a smoother noise. The 3D noise is defined relative to
the local space of the line modifier shape.
Brush Tube Attributes
In order for these settings
to have any effect they require that a Paint Effects brush
be used with tubes turned on.
- Force
-
Acts as a force pushing
tubes away from the center of the line modifier shape. Positive
values push away from the center while negative values push towards
the center. To have an effect this requires that a brush be used
with tubes turned on. For example, use this to push Paint
Effects trees as if with the wind.
- Directional Force
-
Acts as a force pushing
tubes along the local x axis of the line modifier shape. To have
an effect this requires that a brush be used with tubes turned on.
- Displacement
-
Acts as a displacement
pushing tubes away from the center of the line modifier shape. Positive values
push away from the center while negative values push towards the
center. This is similar to the force attribute, but tube segments
further down the tube are not affected by the offset. To have an
effect this requires that a brush be used with tubes turned on.
- Directional Displacement
-
Acts as a displacement
pushing tubes along the local x axis of the line modifier shape.
To have an effect this requires that a brush be used with tubes
turned on. This is similar to the directional force attribute, but
tube segments further down the tube are not affected by the offset.
- Tube Scale
-
Can be used to scale
the length and width of generated Paint Effects tubes.
A value of 1.0 will have no effect and a value of 0.0 scales the
tubes to nothing, resulting in no tubes generated. The behavior
is similar to modifying the brush’s Global Scale.
To have an effect this requires that a brush be used with tubes
turned on.
- Tube Dropout
-
Can be used to reduce
the number of Paint Effects tubes generated.
A value of 0.0 will have no effect and a value of 1.0 will result
in no tubes generated. To have an effect this requires that a brush
be used with tubes turned on.
- Leaf Scale
-
Multiplies the size of
leaves used by the Paint Effects brush. A value
of 1.0 will have no effect and a value of 0.5 will reduce leaf size
by half. To have an effect this requires that a brush be used with
tubes turned on.
- Leaf Dropout
-
Adds on to the current
leaf dropout value used by the Paint Effects brush.
A value of 0.0 will have no effect and a value of 1.0 will increase the
dropout by 1.0. To have an effect this requires that a brush be
used with tubes turned on.
- Flower Scale
-
Multiplies the size of
flowers used by the Paint Effects brush. A value
of 1.0 has no effect and a value of 0.5 reduces flower size by half.
To have an effect this requires that a brush be used with tubes
turned on.
- Flower Dropout
-
This value adds on to
the current flower dropout value used by the Paint
Effects brush. A value of 0.0 has no effect and a value
of 1.0 increases the dropout by 1.0. To have an effect this requires that
a brush be used with tubes turned on.
- Branch Dropout
-
This value adds on to
the current branch dropout value used by the Paint
Effects brush. A value of 0.0 has no effect and a value
of 1.0 increases the dropout by 1.0. To have an effect this requires
that a brush be used with tubes turned on.
- Twig Dropout
-
This value adds on to
the current branch dropout value used by the Paint
Effects brush. A value of 0.0 has no effect and a value
of 1.0 increases the dropout by 1.0. To have an effect this requires
that a brush be used with tubes turned on.