Spline (Poly Quadratic)
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.
Inputs
Preview Grayscale
The preview of the input splines as a grayscale image.
Spline Coords Color
The 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.
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 Color
Additional data of the input splines encoded in the RGBA channels of a color image.
R - Tangents X
G - Tangents Y
B - Unused
A - Unused
R - Tangents X
G - Tangents Y
B - Unused
A - Unused
Spline Amount Integer
The number of input splines.
Points Preview Grayscale
The 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.
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.
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.
Outputs
Preview Grayscale
The preview of the output splines as a grayscale image.
Spline Coords Color
The 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.
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 Color
Additional data of the output splines encoded in the RGBA channels of a color image.
R - Tangents X
G - Tangents Y
B - Unused
A - Unused
R - Tangents X
G - Tangents Y
B - Unused
A - Unused
Spline Amount Integer
The number of output splines.
Parameters
Points Amount Integer
The arbitrary number of points used to build the spline.
Input Spline Connection Mode Integer
The 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.
- 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 Boolean
Controls 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.
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 Boolean
Use 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.
The list of points can be supplied by a Point List node.
Connect Start to Input Spline Boolean
When 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.
This value is the normalized length of the selected input spline.
Connect End to Input Spline Boolean
When 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.
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 Correction Boolean
Adjust the points’ positions and thickness to retain the spline shape in non-square resolutions.
This also impacts uniform distribution.
This also impacts uniform distribution.
Global Smoothness Adjustment Float
Applies a uniform offset to the smoothness value of all points.
The resulting smoothness value is clamped to the [0;1] range.
The resulting smoothness value is clamped to the [0;1] range.
Points Properties
p# Properties Float3
Sets 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.
- 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.
Points Coordinates
p# Float2
Sets the position of the p# point in texture space.
Preview
Show Tangents Boolean
Displays the tangents of the p1 and p3 points to p2 in the Preview output.
Show Direction Helper Boolean
Displays 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 Integer
Adjusts the number of segments used to draw the spline visualization in the Preview output.
A higher value results in a smoother line.
A higher value results in a smoother line.
Thickness (px) Float
Adjusts the thickness of the spline visualization in pixels in the Preview output.
Examples
| table 0-row-2 html-authored no-header | |
|---|---|
Before |
After |
recommendation-more-help
substance-3d-designer-help-guide