Houdini 20.5 Nodes Copernicus nodes

SDF Shape Copernicus node

Builds a 2D signed distance field of a selected shape.

On this page

This node generates a 2D signed distance field for various shapes. The node outputs a Mono image layer with negative (inside the shape) and positive values (outside the shape). You can use this field to combine it with other fields using SDF Blend to create more complex shapes.

To convert the field’s values into a usable image shape, use the SDF to Mono or SDF to RGB.

Note

By default, the node uses a visualizer to display the field. To display the real values of the field use a Layer Properties with Type Info on and set to None.

Parameters

Shape

Shape Class

Shapes are organized into various groups. Basic shapes are consist of elementary algebraic shapes, while Marker and Compound contain shapes of various complexities.

Basic Shapes

The list of available elementary algebraic shapes when Shape Class is set to Basic.

See Basic Shapes for more information.

Markers

The list of available marker shapes when Shape Class is set to Marker.

See Markers for more information.

Compound Shapes

The list of available complex shapes when Shape Class is set to Compound.

See Compound Shapes for more information.

Basic Shapes

Radius

The radius of the circle. Use this parameter to control the size of the circle.

Arc

When turned on, and the value is less than 1, the circle becomes an open arc, which can be used to create shapes of a sliced pie.

Thickness

When turned on, and the value is less than 1, the circle becomes hollowed, which can be used to create ring-like shapes.

Round Ends

When both Arc and Thickness are turned on, use this to make the end of the ring shape rounded.

Quadratic Circle

When turned on, the circle changes into a quadratic circle shape.

Size

Controls the horizontal and vertical size of the diamond shape.

Length

Sets the length of the line, which is oriented horizontally at the center. Turn on Use Points next to this parameter if you need to control the exact positions for the start and end points of the line.

Use Points

When this is turned on, the start and end points of the lines can be controlled by Start Point and End Point parameters.

Start Point

Sets the horizontal and vertical position for the start point of the line.

End Point

Sets the horizontal and vertical position for the end point of the line.

Add Thickness

When turned on, the start and end thickness of the lines can be controlled by Start Thickness and End Thickness.

Start Thickness

The thickness of the line at the start point.

End Thickness

The thickness of the line at the end point.

Bulge

When turned on, controls the thickness at the center of the line. A value of 0 means no bulging. In this mode, only Start Thickness is on to control the same thickness at both ends of the line.

Size

Controls the horizontal and vertical size of the rectangle shape.

Round Corners

When turned on, controls the roundness of the corners. With a value of 1 and both horizontal and vertical size is equal, the shape becomes a circle. When this is set to 0, the rectangle is not rounded. Use Separate Controls next to this parameter to control the roundness for each corner separately.

Separate Controls

When turned on, the roundness of each corner can be controlled separately.

Top Left

Controls the roundness for the top left corner of the rectangle. Value of 1 means the corner is rounded to the maximum, and the value of 0 means that the corner is not rounded.

Top Right

Controls the roundness for the top right corner of the rectangle. Value of 1 means the corner is rounded to the maximum, and the value of 0 means that the corner is not rounded.

Bottom Left

Controls the roundness for the bottom left corner of the rectangle. Value of 1 means the corner is rounded to the maximum, and the value of 0 means that the corner is not rounded.

Bottom Right

Controls the roundness for the bottom right corner of the rectangle. Value of 1 means the corner is rounded to the maximum, and the value of 0 means that the corner is not rounded.

Radius

The size of the radius for the polygon shape.

Number of Sides

Controls the number of sides for the polygon. The larger the number the more the shape will resemble a circle.

Radius

The size of the radius for the spiral shape.

Arc Bend

Controls how much each arc length segment should bend towards the center. When this value is set to 0 and the Number of Arcs is set to 4, the arc is a perfect circle.

Number of Arcs

Controls the number of components the spiral is made of. When Arc Bend is set to 0, a value of 4 creates a perfect circle.

Radius

The size of the radius for a squircle, which is a shape intermediate between a square and a circle.

Blend

Controls the shape of the squircle. The value of 2 creates a perfect circle. Values above this will blend the shape more into a square. A value of 1 creates a diamond shape.

Radius

The size of the radius for the star shape.

Number of Sides

Controls the number of sides for the star. The larger the number, the more the shape will resemble a circle.

Angle Factor

Controls how much the center of the sides push towards the center of the shape. The angle factor of 2 will create a regular polygon shape instead of a star.

Height

Controls the vertical height of the trapezoid.

Bottom Length

Controls the horizontal length at the bottom of the trapezoid.

Top Length

Controls the horizontal length at the top of the trapezoid.

Width

Controls the horizontal length at the bottom of the triangle.

Height

Controls the vertical height of the triangle.

Use Points

When this is turned on, the three corners of the triangle are controlled by Point0, Point1 and Point2 parameters.

Point 0

Controls the bottom left corner position of the triangle.

Point 1

Controls the top corner position of the triangle.

Point 2

Controls the bottom right corner position of the triangle.

Arc

Controls the amount of distortion applied to the wave. Values closer to 0 will make the wave look like a flat line. The value of 0.5 closer resembles a sine wave, while a value of 1 will fold the wave pattern onto each other.

Element Size

Controls the size of the wave pattern. Lower values will make smaller patterns.

Markers

Size

The radius of the marker. Use this parameter to control the size of the shape.

Compound Shapes

Width

Controls the horizontal width of the arch. Increase this value to make the shape wider.

Height

Controls the vertical height of the arch. The value of 0 creates a half-circle.

Length

Controls the overall length of the arrow, both shaft and head. After adjusting the length, use the Head Ratio to control the size of the head relative to the new arrow length.

Use Points

When this is turned on, the start and end points of the arrow can be controlled by Start Point and End Point parameters.

Start Point

Sets the horizontal and vertical position for the start point of the arrow.

End Point

Sets the horizontal and vertical position for the end point of the arrow.

Shaft Thickness

Sets the vertical thickness of the shaft of the arrow. Increase this parameter to make the shaft thicker.

Head Thickness

Sets the vertical thickness of the head of the arrow. Increase this parameter to make the head thicker.

Head Ratio

Sets the horizontal ratio between the head and the shaft of the arrow.

Cross Size

Controls the overall size of the cross shape.

Cross Inset

Controls the amount to chip away from the corners of a square. When this value is set to 0, the result is a perfect square. Increasing this value will chip away the shape starting from the corners of the square.

Cross Bevel

Controls the amount of rounding at the inner corner of the cross.

Radius

The size of the radius for the egg.

Roundness

Controls the roundness of the top edge of the egg. A value of 0 creates an egg shape with a sharp top edge, and increasing this value smooths the top edge. The value of 1 will create a perfect circle shape.

Thickness

Controls the thickness of the fishscale shape. This shape is generally used for fishscale-like tile patterns.

Size

The overall size of the horseshoe.

Separation

Controls the arc length of the horseshoe. The value of 0 creates a perfect round shape, closing both ends of the horseshoe.

Length

Controls the extent of each end of the horseshoe.

Thickness

Controls the thickness of the horseshoe.

Outter Radius

Controls the overall radius of the moon. For a generic moon shape, this parameter should be larger than Inner Radius.

Inner Radius

Controls the radius of the shape that will be cut out from the body of the moon given by Outter Radius.

Inner Offset

The horizontal position of the inner shape given by Inner Radius to control where to cut into the moon.

Thickness

Controls the thickness of the octagon-dot shape. This shape is generally used for octagon-dot-like tile patterns.

Size

Controls the overall size of the cross. The value of 0 creates a perfect circle.

Thickness

Controls the thickness of the cross.

Radius

The size of the radius for the vesica.

Roundness

Controls the vertical thickness of the vesica shape. Increasing this value makes the shape more rounded.

Transform

Translate

The amount of horizontal and vertical translation.

Rotate

The amount of rotation.

Shear

The amount of shearing.

Uniform Scale

The amount of uniform scaling.

Inputs

size_ref

A representative layer that determines the size of the output image and controls the metadata.

Outputs

sdf

The SDF Mono layer.

See also

Copernicus nodes