Spline (Poly Quadratic)

table 0-row-2 0-border-0px 1-border-0px 1-width-33.33% 2-border-0px 2-width-100.00% html-authored no-header
In: Spline & Path Tools > Spline Tools	Description Generates a spline along several points. The amount and locations of these points may be arbitrary or gathered from a Point List node.

The trajectory of the spline can be smoothed away from its intermediary points, in that each intermediary point is the meeting point of the ‘out’ and ‘in’ tangents of its neighbours.

Input connectors

Preview GrayscaleThe preview of the input splines as a grayscale image.

Spline Coords ColorThe coordinates of the input splines’ points encoded in the RGBA channels of a color image:
    R - X position
    G - Y position
    B - Height
    A - Packed data:
        * Sign: Spline is closed (negative) or open (positive);
        * Absolute value: Thickness + 1.

Spline Data ColorAdditional data of the input splines encoded in the RGBA channels of a color image.
    R - Tangents X
     G  - Tangents Y
     B  - Unused
     A  - Unused

Spline Amount IntegerThe number of input splines.

Points PreviewGrayscaleThe preview of the points as a grayscale image.

Input Point List Color (available when ‘Use Input Point List’ is True)
A list of points encoded in the RGBA channels of a color image:
    R - X position
     G  - Y position
     B  - Height
     A  - Packed data:
        * Integer part: Smoothness;
        * Fractional part: Thickness.

Point Number Integer (available when ‘Use Input Point List’ is True)
The number of points.

note important
IMPORTANT
The Point List and Point Number connectors are not compatible with Spline Coord, Spline Data and Spline Amount connectors, for they rely on different data.

Output connectors

Preview GrayscaleThe preview of the output splines as a grayscale image.

Spline Coords ColorThe coordinates of the output splines’ points encoded in the RGBA channels of a color image.
    R - X position
     G  - Y position
     B  - Height
    A - Packed data:
        * Sign: Spline is closed (negative) or open (positive);
        * Absolute value: Thickness + 1.

Spline Data ColorAdditional data of the output splines encoded in the RGBA channels of a color image.
    R - Tangents X
     G  - Tangents Y
     B  - Unused
     A  - Unused

Spline Amount IntegerThe number of output splines.

Parameters

Points Amount IntegerThe arbitrary number of points used to build the spline.

Input Spline Connection Mode IntegerThe method used to connect the input Splines:
- Auto: The end of the last input spline is connected to the start of the generated spline, and the end to the generated spline is connected to the start of the first input spline;
- Manual: You can specify which of the input splines should be connected to the extremities of the generated spline, and where on the input splines these connections should land.

Close Spline BooleanControls whether the end point of the spline should be connected to its start point.
The smoothing applied to the spline at the start and end points is specified by the Smoothness values of those points.

Flip Direction Boolean
Inverts the direction of the spline.

Use Input Point List BooleanUse the list of points supplied to the Input Point List and Point Number input connectors instead of an arbitrary list of points.
The list of points can be supplied by a Point List node.

Connect Start to Input Spline BooleanWhen True, the start of the generated spline is connected to the last point of the last spline in the input splines.

Start Connection Spline Index Integer (Available when ‘Input Spline Connection Mode’ is set to ‘Manual’ and ‘Connect Start to Input Spline’ is set to ‘True’)The index of the input spline which should be connected to the start of the generated spline.

Start Connection Position Float (Available when ‘Input Spline Connection Mode’ is set to ‘Manual’ and ‘Connect Start to Input Spline’ is set to ‘True’)The position on the selected input spline where the connection to the start of the generated spline should land.
This value is the normalized length of the selected input spline.

Connect End to Input Spline BooleanWhen True, the end of the generated spline is connected to the first point of the first spline in the input splines.

End Connection Spline Index Integer (Available when ‘Input Spline Connection Mode’ is set to ‘Manual’ and ‘Connect End to Input Spline’ is set to ‘True’)The index of the input spline which should be connected to the end of the generated spline.

End Connection Position Float (Available when ‘Input Spline Connection Mode’ is set to ‘Manual’ and ‘Connect End to Input Spline’ is set to ‘True’)The position on the selected input spline where the connection to the end the generated spline should land.
This value is the normalized length of the selected input spline.

Uniform Distribution Boolean
When True, the points of the spline are evenly spaced from start to end.

Append Input Spline Boolean
Adds the generated spline to the end of the list of splines connected to the Spline inputs.

Non-Square CorrectionBooleanAdjust the points’ positions and thickness to retain the spline shape in non-square resolutions.
This also impacts uniform distribution.

Global Smoothness Adjustment FloatApplies a uniform offset to the smoothness value of all points.
The resulting smoothness value is clamped to the [0;1] range.

accordion
Points Properties
p# Properties Float3Sets the properties of the p# point. - Height: Adjusts the height of the point where a lower value means a lower or deeper location; - Smoothness: Offsets the start of the smoothing of the spline at p#, where a value of 0 results in a hard trajectory and 1 in an entirely smooth one; - Thickness: Adjusts the thickness of the spline at p#. Thickness is used by specific Spline nodes.

accordion
Points Coordinates
p# Float2Sets the position of the p# point in texture space.

accordion
Preview
Show Tangents BooleanDisplays the tangents of the p1 and p3 points to p2 in the Preview output. Show Direction Helper BooleanDisplays a dot at the start of the spline and an arrowhead at its end in the Preview output. Show Thickness Envelope Boolean Displays additional lines at the edges of the spline’s thickness. Show Points Label Boolean For each point, displays the point’s name next to it in the ‘Preview’ output. Points Label Size Float (Available when ‘Show Points Label’ is set to ‘True’) The size of the label for each point in texture space, where 0.1 is a tenth of the texture’s width. Show Points Boolean Displays the control points for the spline. Points Size Float (Available when ‘Show Points’ is set to ‘True’) The radius of the points in texture space, where 0.1 is a tenth of the texture’s width. Segments Amount IntegerAdjusts the number of segments used to draw the spline visualization in the Preview output. A higher value results in a smoother line. Thickness (px) FloatAdjusts the thickness of the spline visualization in pixels in the Preview output.

Examples

table 0-row-2 1-row-2 0-border-0px 1-border-0px 5-border-0px html-authored no-header
table 0-row-2 html-authored no-header Before After