{{ :tools:s-tk:pasted:20190823-143956.png}}
====== 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 [[tools:s-tk:primitive|]] or the [[tools:s-tk:prefs|]].

===== Controls =====
==== Spline ====

Select the [[tools:s-tk: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 [[tools:s-tk: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.