Differences

This shows you the differences between two versions of the page.

--- tools:s-tk:displacement-node [2019/08/22 17:18] – lightwolf
+++ tools:s-tk:displacement-node [2019/08/25 18:47] (current) – [Spline Displacement (Node)] lightwolf
@@ Line 1: / Line 1: @@
-====== Spline Displacement (in development, Node) ======
+{{ :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.