lineModifiernode

 
 
 

This node is created when you create a Paint Effects line modifier (Paint Effects > 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.

Occupation Volume

Occupation Volume includes a group of interdependent attributes that affect the direction of branch growth, while influencing branch size and density.

Use Occupation Volume to create foliage effects that are based on the natural growth patterns of branches, vines, and bushes.

Occupy Attraction

Creates a force at points in a line modifier volume which attracts the end-points of the nearest Paint Effects tube. The attractive force influences tubes to grow toward the point in the volume until a tube occupies the region around the point. After the tube end-point grows to the volume point, it occupies that space, and the point no longer attracts other tube end-points.

Higher Occupy Attraction values increase the tendency of the tube ends-points to grow toward the nearest point. As the force increases, greater sharpness in the angles of branching tubes occurs as the tube end-points migrate to decreasingly available space.

Attract Radius Scale and Occupy Radius Scale attribute values and Occupy Branch Termination affect how tubes end-points are influenced by the Occupy Attraction force.

Attract Radius Scale

Specifies a value that is multiplied by the radius of the Paint Effects tubes to determine the region of unoccupied space that attracts tube end-points. For example, when set to 1, the region attracting a tube end-point is equal to the tube's radius. Attract Radius Offset also affects how the attract radius is calculated.

As Attract Radius Scale values increase, the number of points that the tube end-points are attracted to increases. This lets smaller branches grow into unoccupied space. When the Attract Radius Scale value is greater than Occupy Radius Scale, smaller branches terminate less frequently.

Attract Radius Offset

Specifies a value that is added to the radius of the Paint Effects tubes to determine the region of unoccupied space that attracts tube end-points. Attract Radius Scale also affects the size of the attract radius.

Occupy Radius Scale

Specifies a value that is multiplied by the radius of the Paint Effects tubes to determine the region of space that the tube occupies when it is attracted to a point.

Lower Occupy Radius Scale values allow more space to be colonized by larger numbers of branching tubes. Increasing Occupy Radius Scale while keeping Occupy Radius Offset to near 0 values lets thinner branches occupy the same space occupied by larger and thicker branches.

When the Occupy Radius Scale value is greater than Attraction Radius Scale, smaller branches terminate more frequently.

Occupy Radius Offset

Specifies a value that is added to the radius of tubes to determine the region of space that a tube occupies when it is attracted to a point. Occupy Radius Scale also affects the size of the occupy radius.

Occupy Grid Resolution

Specifies the resolution the of voxel point grid used by the Occupation Volume of the line modifier. This value determines the number of points in worldspace along the longest axis of the line modifier Shape.

Increasing the Occupy Grid Resolution increases the total number of points that attract tube end points.

Occupy Branch Termination

When on, branches attracted into occupied space are terminated.

Related topics:

Creative Commons License Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License