db&w documentation wiki

finest software | finest docs

Site Tools


tools:s-tk:displacement-node

Spline Displacement (Node)

This node evaluates the distance to a point on a spline and outputs a displacement to that closest point.

The accuracy of this node relies on the number of Evaluation Steps defined in the Spline Primitive or the Spline Preferences.

Controls

Spline

Select the Spline Primitive to use in this node.

World Coordinates

Evaluates the spline in world coordinates.

Minimum Distance

Maximum Distance

These two define the minimum and maximum range for the displacement. Anything at or below the minimum will be 100% displaced, anything at or beyond the maximum will not be displaced at all.

Strength

This is the strength of the displacement and may be negative as well, pushing away from the spline.

Distance Evaluation

This controls how the distance to the spline, which drives the displacement, is computed.

  • 3D Evaluates the distance in all three directions.
  • YZ Only evaluates on a YZ plane, ignoring the along X.
  • XZ Only evaluates on a XZ plane, ignoring the along Y.
  • XY Only evaluates on a XY plane, ignoring the along Z.

Connections

Inputs

Position

The position to find the closes point in the spline to. If this is not connected, then the current position provided by LightWave 3D is used.

MinDistance

MaxDistance

These two define the minimum and maximum range for the displacement. Anything at or below the minimum will be 100% displaced, anything at or beyond the maximum will not be displaced at all.

Strength

This is the strength of the displacement and may be negative as well, pushing away from the spline.

Function

The node connected to the function input is applied to the blending strength between the original position and the displaced position. This allows you to shape/modify the falloff.

Outputs

Displacement

A displacement vector that can be plugged directly into the Input of the Displacement Node Editor.

Axis Displacement

If the Distance Evaluation is not set to 3D, this will output a displacement vector along the axis that is not used for the evaluation.

For example, if the Distance Evaluation is set to XZ, then the Axis Displacement will return a vector along the Y axis only.

Strength

This is the strength of the displacement, as a value from 0 to 1, and takes the Function input into account as well. It's almost identical to the normalised output in the Spline Proximity (node). This can be used like a weight to, for example, drive the positioning of instances.

Position

The position of the closes point on the spline.

Direction

The direction to the closest point on the spline.

Distance

The distance to the closest point on the spline.

tools/s-tk/displacement-node.txt · Last modified: 2019/08/25 18:47 by lightwolf