Spline Sample Height

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 Modifies the height of the input splines by mapping an input Height Map onto them. The effect of the mapped height map can be adjusted by changing its blending mode and the opacity of that effect.

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.

Height Map GrayscaleThe input grayscale image used to change the input spline’s height.

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

Sampling Mode IntegerThe method of mapping the values in the Height Map to the splines:
- Texture space: The values are applied to the splines where they would be if placed in a texture using the texture’s UV coordinates. This effectively applies the value to the splines ‘in place’;
- Horizontal along spline: The values are applied to the encoded splines’ coordinates directly (see Spline Coords input), where each row is applied to a different spline from top to bottom;
- Hor. along spline (rand. offset X): The values are applied to the encoded splines’ coordinates directly (see Spline Coords input), with a random horizontal offset in the Scale map for each spline (I.e., each row in Spline Coords);
- Hor. along spline (rand. offset Y): The values are applied to the encoded splines’ coordinates directly (see Spline Coords input), with a random vertical offset in the Scale map for each spline (I.e., each row in Spline Coords).

Opacity FloatA multiplier for the intensity of the Height Map input’s contribution to the spline’s height.

Blending Mode IntegerThe method of blending the Height Map’s data with the input spline’s height:
- Copy: Override the spline’s height with the Height Map values;
- Add: Add the Height Map values to the spline’s height;
- Subtract: Subtract the Height Map values to the spline’s height;
- Multiply: Multiply the Height Map values against the spline’s height.

accordion
Preview
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. 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. Thickness (px) FloatAdjusts the thickness of the spline visualization in pixels in the Preview output.

Examples

table 0-row-2 1-row-2 2-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	table 0-row-2 html-authored no-header Before After

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