Spline (Cubic)

Node icon

In: Spline & Path Tools > Spline Tools

Description

Generates a single spline between two points p1 and p2 at arbitrary locations.

The trajectory of the spline is controlled by the ‘out’ tangent of p1 and the ‘in’ tangent of p2.

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.

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

Flip Direction Boolean
Inverts the direction of the spline.

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.

Height

Start Height FloatAdjusts the height of the p1 point where a lower value means a lower or deeper location.
This impacts the height of the spline at p1.

End Height FloatAdjusts the height of the p2 point where a lower value means a lower or deeper location.
This impacts the thickness of the spline at p2.

Auto Tangent Height BooleanAutomatically sets the height of the spline tangents to interpolate linearly from the Start Height to the End Height.

p1 Tangent Height Float (available when ‘Auto Tangent Height’ is True)
Adjusts the height of the p1 point ‘out’ tangent where a lower value means a lower or deeper location.
This impacts the height along the spline as it draws away from p1.

p2 Tangent Height Float (available when ‘Auto Tangent Height’ is True)
Adjusts the height of the p2 point ‘in’ tangent where a lower value means a lower or deeper location.
This impacts the height along the spline as it draws away from p2.

Thickness

Start Thickness FloatAdjusts the thickness of the p1 point.
This impacts the thickness of the spline at p1.
Note: Thickness is used by specific Spline nodes.

End Thickness FloatAdjusts the thickness of the p2 point.
This impacts the thickness of the spline at p2.
Note: Thickness is used by specific Spline nodes.

Auto Tangent Thickness BooleanAutomatically sets the thickness of the spline tangents to interpolate linearly from the Start Thickness to the End Thickness.
Note: Thickness is used by specific Spline nodes.

p1 Tangent Thickness Float (available when ‘Auto Tangent Thickness’ is True)
Adjusts the thickness of the p1 point ‘out’ tangent.
This impacts the thickness along the spline as it draws away from p1.
Note: Thickness is used by specific Spline nodes.

p2 Tangent Thickness Float (available when ‘Auto Tangent Thickness’ is True)
Adjusts the thickness of the p2 point ‘in’ tangent.
This impacts the thickness along the spline as it draws away from p2.
Note: Thickness is used by specific Spline nodes.

Points Coordinates

p1 Float2Sets the position of the p1 point in texture space.

p1 Tangent Float2Sets the position of the p1 point ‘out’ tangent handle in texture space.

p2 Float2Sets the position of the p2 point in texture space.

p2 Tangent Float2Sets the position of the p2 point ‘in’ tangent handle in texture space.

Preview

Show Tangents BooleanDisplays the p1 point ‘out’ tangent and p2 point ‘in’ tangent 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.

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 in pixels of the spline visualization in the Preview output.

Examples

Node example 1
Node example 2
Node example 3
recommendation-more-help
dd48abc6-e399-43d2-9777-578ec70c5a23