Radiant Sdf on Radiant SDF Docs

Center Space

Mon, 01 Jan 0001 00:00:00 +0000

Center Space

Inputs

float2 Space

Behaviour

Centers the provided space (TexCoords0 by default) so \((0,0) \) is the middle point on the coordinates. This is very useful for later manipulation and makes especially rotation simpler to reason about.

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Getting Started

After downloading and installing RadiantSdf make sure you enter it as a dependency into your .uproject file.

"Plugins": [
 ...
 {
 "Name": "RadiantSDF",
 "Enabled": true
 },
 ...
]

Alternatively, you can enable the plugin using the editor using the Plugins window found under Edit/Plugin.

After this, all material nodes are available inside the project, though you might need to recompile the project in order to access them. All Nodes are found under the RadiantSDF category in the material editor when adding a node.

Operation Union

Mon, 01 Jan 0001 00:00:00 +0000

Operation Union

Inputs

float Left

float Right

Behaviour

Combines two signed distance fields into a single distance field. This operation only leaves the outside of the distance field intact. The interior will not be a mathematically correct distance field after this operation.

Scaling Space

Mon, 01 Jan 0001 00:00:00 +0000

Scaling Space

Scaling space sadly is not possible within a single node or Material function within UE5s material graph, as it would require passing the signed distance field as a function into the scaling node. However, the technique can still be performed though in a slightly awkward way.

In order for the scaling to work correctly, one needs to:

Divide the space by the desired Scale
Calculate the signed distance field function that needs to be scale using the divided space
Multiply the resulting signed distance field by the scale to keep the distance values correct

In order to do this for more complex shapes, I recommend to use named reroute nodes, this keeps the process a lot more tidy.

SDF Circle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Circle

Inputs

float Radius | default 0.5

Behaviour

Outputs the signed distance field for a circle, based on the provided radius.

Visualize

Mon, 01 Jan 0001 00:00:00 +0000

Visualize SDF

Inputs

float2 SDF

float3 Inner Color

float2 Outside Color

float2 Outline Color

Behaviour

Provides a way to visualize the signed distance field with custom colorization.

Default Colorization

Custom Colorization

Operation Smooth Union

Mon, 01 Jan 0001 00:00:00 +0000

Operation Smooth Union

Inputs

float Left

float Right

float SmoothingFactor | default 0.0

Behaviour

Combines two signed distance fields into a single distance field, including a smoothing factor. Increased smoothing factors soften the transition between signed distance field shapes. This operation only leaves the outside of the distance field intact. The interior will not be a mathematically correct distance field after this operation.

Rotate Space

Mon, 01 Jan 0001 00:00:00 +0000

Rotate Space

Inputs

float2 Space

float Angle | default 0.1

Behaviour

Rotates the provided space by the given angle (in degrees). The following figures are rotated by 45 degrees.

SDF CutCircle

Mon, 01 Jan 0001 00:00:00 +0000

SDF CutCircle

Inputs

float Radius | default 0.5

float CutHeight | default 0.3

Behaviour

Outputs the signed distance field for a CutCircle, based on the provided Radius. Where in the circle the cut is placed can be controlled with the CutHeightparameter. 0 - 0.5 is the upper half of the circle, whilst 0.5 - 1.0 is the lower half.

Mirror Space

Mon, 01 Jan 0001 00:00:00 +0000

Mirror Space

Inputs

float2 Space

Behaviour

Allows to mirror the provided space along the x, y or xy axis. Mirroring complex signed distance field shapes is highly efficient and is recommended over constructing them multiple times.

Properties

ESpaceMirrorAxis MirrorAxis

MirrorAxis controls which axis will be mirrored using the mirror node. You can find this property in the Details panel when selecting the node.

Operation Outline

Mon, 01 Jan 0001 00:00:00 +0000

Operation Outline

Inputs

float Sdf

float Thickness | default 0.1

Behaviour

Generates an outline from the provided signed distance field. The outline will be the expanded by the provided thickness parameter.

SDF Quircle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Quircle

Inputs

float Radius | default 0.5

Behaviour

Outputs the signed distance field for a Quircle, based on the provided Radius.

Operation Hard Shape

Mon, 01 Jan 0001 00:00:00 +0000

Operation Hard Shape

Inputs

float SDF

Behaviour

Converts the signed distance field to a mask, where outside of the sdf is black and inside of the sdf is white. The Transition is a hard but antialiased line.

Properties

EHardShapeFunction HardShapeFunction | default Smoothstep

With the HardShapeFunction property one may choose which function to use in order to generate the hard shape.

Smoothstep: generally the cheapest and good results over all.
MaxDerivative: more expensive but provides better results for very thin shapes
MaxUVDerivative: requires the base space used for the SDF but has the best results for very thin shapes. However it may break when the sdf is not exact anymore.

SmoothStep

Max Derivative

Max UV Derivative

Operation Intersection

Mon, 01 Jan 0001 00:00:00 +0000

Operation Intersection

Inputs

float Left

float Right

Behaviour

Generates the intersection between the two provided signed distance fields. The overlapping area is preserved, the rest is removed.

Operation Soft Shape

Mon, 01 Jan 0001 00:00:00 +0000

Operation Soft Shape

Inputs

float Sdf

float Softness | default 0.1

Behaviour

Turns the signed distance field into a mask with softly feathered edges. Outside of the sdf will be fully black inside will be white and the border transition softly between.

Properties

ESoftShapeFunction SoftShapeFunction | default Smoothstep

With the SoftShapeFunction property one may choose which function to use in order to generate the soft shape.

Linear: the cheapest option, provides a linear gradient over the edge
Smoothstep: good results over all, provides a smooth gradient over the edge.
ExpStep: a faster, yet smooth falloff than Smoothstep
LogStep: an extremely fast falloff

The following figures are at Softness of 0.01.

Repeat Space

Mon, 01 Jan 0001 00:00:00 +0000

Repeat Space

Inputs

float2 Space

float2 RepetitionDistance | default float2(1.0, 1.0)

Behaviour

The Repeat Space Node can be used to repeat the provided space infinitely or a specified amount of time. In addition, the space between the repetitions can be set with the RepetitionDistance parameter. Repeating signed distance field shapes is generally recommended over constructing multiple versions.

Properties

ESpaceRepetition Mode

The repeat node can work in two modes, Infinite and Limited, though the default is Infinite. As the name suggests, when in Infinite mode the repetition has no limit and is just controlled by the RepetitionDistance input.
In Limited mode the Repetitions property becomes available allowing to clamp the number of repetitions that are performed to any integer number.

SDF Squircle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Squircle

Inputs

float Radius | default 0.5

float Roundness | default 0.2

Behaviour

Outputs the signed distance field for a Squircle, based on the provided Radius. Roundness determines how much the corners are rounded but keeps the sdf radius the same. Roundness is only well defined between 0- 1, values above 1 lead to collapse of the corners to the inside.

Operation Smooth Intersection

Mon, 01 Jan 0001 00:00:00 +0000

Operation Smooth Intersection

Inputs

float Left

float Right

float SmoothingFactor | default 0.0

Behaviour

Performs an intersection between two signed distance fields, combining both to a new single output and smoothing the transition by the smoothing factor.

Resources

Mon, 01 Jan 0001 00:00:00 +0000

Resources

If you want to read up a bit more on signed distance fields, how to use them and their benefits here are some links.

Information and Learning

SDF Rectangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Rectangle

Inputs

float2 Extents | default float2(0.3, 0.5)

Behaviour

Outputs the signed distance field for a rectangle, based on the provided extents.
Extents is the total size of the resulting rectangle.

Versions

Mon, 01 Jan 0001 00:00:00 +0000

Versions

1.0

Initial Release

1.01

Distance functions

Added Pentagon
Added Hexagon
Added Octogon
Added NGon
Added NPointed Star
Added Symmetric Trapezoid
Added Ring Segment

1.02

Engine Support

Added support for UE 5.5
Added support for UE 5.6

Distance functions

Added Cross
Added Moon
Added Cut Circle
Added Quircle
Added Squircle

Operations

Added Soft Shape with 4 functions for shape generation
- Linear
- Smoothstep
- Expstep
- Logstep
Updated Hard Shape to allow for function selection between
- Smoothstep
- Max Derivative
- Max UV Derivative

1.03

Distance functions

Added Heart
Added Egg
Added Ellipse
Added Rounded X
Added Pie

Operation Round

Mon, 01 Jan 0001 00:00:00 +0000

Operation Round

Inputs

float Sdf

float Roundness | default 0.1

Behaviour

Generates a rounded version from the provided signed distance field. The roundness parameter controls how much the signed distance field is rounded.

SDF Chamfered Rectangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Chamfered Rectangle

Inputs

float2 Extents | default float2(0.3, 0.5)

float Chamfer | default 0.1

Behaviour

Outputs the signed distance field for a chamfered rectangle, based on the provided extents.
Extents is the total size of the resulting rectangle.
Chamfer is given as a percentage of the side length. A chamfer of 0.5 will result in a diamond shape.

Operation Subtract

Mon, 01 Jan 0001 00:00:00 +0000

Operation Subtract

Inputs

float Left

float Right

Behaviour

Performs a subtraction between two signed distance fields, Right will be subtracted from Left.

SDF Rounded Rectangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Rounded Rectangle

Inputs

float2 Extents | default float2(0.3, 0.5)

float TopLeftRadius | default 0.1

float TopRightRadius | default 0.1

float BottomRightRadius | default 0.1

float BottomLeftRadius | default 0.1

Behaviour

Outputs the signed distance field for a rounded rectangle, based on the provided extents and the individual corner radii.
Extents is the total size of the resulting rounded rectangle. Corner radii are a percentage of the side length, so 0.5 in each will result in a circle if the extents are equal.

Operation Smooth Subtraction

Mon, 01 Jan 0001 00:00:00 +0000

Operation Smooth Subtraction

Inputs

float Left

float Right

float SmoothingFactor | default 0.0

Behaviour

Performs a smooth subtraction between two signed distance fields, Right will be subtracted from Left. The SmoothingFactor controls how much the resulting transition between subtracted distance fields is smoothed. Higher values mean more smoothing.

SDF Rhombus

Mon, 01 Jan 0001 00:00:00 +0000

SDF Rhombus

Inputs

float2 Extents | default float2(0.3, 0.5)

Behaviour

Outputs the signed distance field for a rhombus, based on the provided extents.
Extents is the total size of the resulting rhombus.

Operation Difference

Mon, 01 Jan 0001 00:00:00 +0000

Operation Difference

Inputs

float Left

float Right

Behaviour

Generates the difference between the two provided signed distance fields. Preserves the area where the ingoing signed distance fields are different.

SDF Parallelogram

Mon, 01 Jan 0001 00:00:00 +0000

SDF Parallelogram

Inputs

float Width | default 0.5

float Height | default 0.5

float Skew | default 0.25

Behaviour

Outputs the signed distance field for a parallelogram, based on the provided width, height and skew. Skew is a percentage relative to the width of the base rectangle. A skew of 0.5 essentially doubles the overall width of the bounding rectangle of the parallelogram.

SDF Symmetric Trapezoid

Mon, 01 Jan 0001 00:00:00 +0000

SDF Symmetric Trapezoid

Inputs

float Height | default 0.5

float UpperLength | default 0.3

float LowerLength | default 0.5

Behaviour

Outputs the signed distance field for a symmetric trapezoid. Height defines the distance from the lower side to the upper side, whereas UpperLength and LowerLength describe the sides’ length respectively.

SDF Pentagon

Mon, 01 Jan 0001 00:00:00 +0000

SDF Pentagon

Inputs

float radius | default 0.5

Behaviour

Outputs the signed distance field for a pentagon, based on the provided Radius. The radius describes the circle that all vertices of the pentagon land on. This node is more efficient than using the NGon Node to create a pentagon.

SDF Hexagon

Mon, 01 Jan 0001 00:00:00 +0000

SDF Hexagon

Inputs

float radius | default 0.5

Behaviour

Outputs the signed distance field for a hexagon, based on the provided Radius. The radius describes the circle that all vertices of the hexagon land on. This node is more efficient than using the NGon Node to create a hexagon.

SDF Octogon

Mon, 01 Jan 0001 00:00:00 +0000

SDF Octogon

Inputs

float radius | default 0.5

Behaviour

Outputs the signed distance field for a octogon, based on the provided Radius. The radius describes the circle that all vertices of the octogon land on. This node is more efficient than using the NGon Node to create a octogon.

SDF NGon

Mon, 01 Jan 0001 00:00:00 +0000

SDF NGon

Inputs

float Points | default 5.0

float Radius | default 0.5

Behaviour

Outputs the signed distance field for a NGon, based on the provided Radius and the number of points. This node is less efficient than the other polygon nodes, but allows for greater flexibility. The Points input is always floored to provide proper outputs while allowing the animation of the amount of points if desired.

SDF Triangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Triangle

Inputs

float2 Point1 | default float2(0.5, 0.5)

float2 Point2 | default float2(0.0, 0.5)

float2 Point3 | default float2(-0.5, -0.5)

Behaviour

Outputs the signed distance field for a triangle, based on the provided points. Though this is the most versatile, it is generally also the most expensive function for creating a triangle. Whenever possible, it is recommended to use the dedicated isosceles or equilateral triangle nodes.

SDF Equilateral Triangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Equilateral Triangle

Inputs

float Radius | default 0.5

Behaviour

Outputs the signed distance field for an equilateral triangle, based on the provided Radius. The radius describes the circle that all three vertices of the triangle land on, making all sides equally long.

SDF Isoceles Triangle

Mon, 01 Jan 0001 00:00:00 +0000

SDF Isosceles Triangle

Inputs

float Width | default 0.5

float Height | default 0.5

Behaviour

Outputs the signed distance field for an isosceles triangle, based on the width and height of the triangle. The figure below uses a width of 0.5 and a height of 1.0. The base will be as long as the provided width, while the length of the legs \(l\) will be equal to \(l=width*cos(45°)\).

SDF Segment

Mon, 01 Jan 0001 00:00:00 +0000

SDF Segment

Inputs

float2 Point1 | default float2(0.0, 0.1)

float2 Point2 | default float2(0.0, 0.9)

float Thickness | default 0.01

Behaviour

Outputs the signed distance field for a line segment drawn between two points. The provided thickness parameter controls how wide the line is, higher thicknesses mimic a capsule.

SDF Slanted Capsule

Mon, 01 Jan 0001 00:00:00 +0000

SDF Slanted Capsule

Inputs

float2 Point1 | default float2(0.0, -0.5)

float Radius1 | default 0.1

float2 Point2 | default float2(0.0, 0.5)

float Radius2 | default 0.2

Behaviour

Outputs the signed distance field for a slanted capsule. When setting the radii to an equal size, the result will be a regular capsule without any slanting.

SDF Ring Segment

Mon, 01 Jan 0001 00:00:00 +0000

SDF Ring Segment

Inputs

float Radius | default 0.5

float Angle | default 270.0

float Thickness | default 0.2

Behaviour

Outputs the signed distance field for a ring segment, based on the provided Radius. The segment can never be a full circle, but may get very close to it. How much of the circle it covers is based on the Angle given in degrees. The Thickness parameter determines how wide the ring segment may be.

SDF N-Pointed Star

Mon, 01 Jan 0001 00:00:00 +0000

SDF N-Pointed Star

Inputs

float Points | default 5.0

float Radius | default 0.5

float Acuteness | default 0.5

Behaviour

Outputs the signed distance field for a n-pointed star, based on the provided Radius ,Points and Acuteness. Points is the number of spikes the star will have, whereas Acuteness determines how “spikey” the star is.

SDF Moon

Mon, 01 Jan 0001 00:00:00 +0000

SDF Moon

Inputs

float Distance | default 0.2

float Radius1 | default 0.5

float Radius2 | default 0.4

Behaviour

Outputs the signed distance field for a Moon. The moon is constructed from two circles defined by Radius1 and Radius2 which are subtracted from each other, while still preserving the SDF. Distance determines how far the circle with Radius2 is from the center of the function. Distance of 0 allows for creation of a donut shape.

SDF Cross

Mon, 01 Jan 0001 00:00:00 +0000

SDF Cross

Inputs

float SideLength | default 0.5

float ArmThickness | default 0.2

float InnerCornerRadius | default 0.1

Behaviour

Outputs the signed distance field for a Cross. Sidelength defines the arms length and the bounding rectangles size. ArmThickenss determines the width of the arms, whilst InnerCornerRadius controls the radii of the corners where the two arms of the cross connect.

SDF Quadratic Bezier

Mon, 01 Jan 0001 00:00:00 +0000

SDF Quadratic Bezier

Inputs

float2 A | default float2(-0.5, 0.0)

float2 B | default float2(0.0, 0.5)

float2 C | default float2(0.5, 0.0)

float Thickness | default 0.01

Behaviour

Outputs the signed distance field for a quadratic bezier curve, based on the provided control points A, B and C. A and C are the two endpoints of the curve, while B is the middle point providing the curvature.
The provided thickness parameter controls how wide the line is.

SDF Egg

Mon, 01 Jan 0001 00:00:00 +0000

SDF Egg

Inputs

float2 RadiusA | default 0.4

float2 RadiusB | default 0.2

float2 Height | default 0.5

float2 Roundess | default 0.5

Behaviour

Outputs the signed distance field for an egg. It is built from two circles which are Height distance apart. RadiusA is the lower circle, RadiusB is the upper one. Roundess defines how the two circle are connected higher values lead to more round eggs, lower values will be more pointy.

SDF Heart

Mon, 01 Jan 0001 00:00:00 +0000

SDF Heart

Inputs

None

Behaviour

Outputs the signed distance field for a heart.

SDF Ellipse

Mon, 01 Jan 0001 00:00:00 +0000

SDF Ellipse

Inputs

float2 Width | default 0.5

float2 Height | default 0.3

Behaviour

Outputs the signed distance field for an ellipse. Width and Height control the bounding box the ellipse will fit inside. If Width == Height a sphere signed distance field will be used as a fallback.

SDF Pie

Mon, 01 Jan 0001 00:00:00 +0000

SDF Pie

Inputs

float2 Angle | default 270

float2 Radius | default 0.5

Behaviour

Outputs the signed distance field for a symmetric pie segment. Angle in degrees is controlling the size of the segment and Radius provides the size of the circle the segment is taken from.

SDF Rounded X

Mon, 01 Jan 0001 00:00:00 +0000

SDF Rounded X

Inputs

float2 Point1 | default float2(0.5, 0.5)

float2 Point2 | default float2(0.0, 0.5)

float2 Point3 | default float2(-0.5, -0.5)

Behaviour

Outputs the signed distance field for a rounded X. Radius controls the radius of the tips of the two crossing lines and SideLength controls the length. All sides are always equally long.

Legal Notice

Mon, 01 Jan 0001 00:00:00 +0000

Legal Notice

radiant pixel interactive e.U.
Inhaber Josua Kucher

Eingetragenes Unternehmen

FN: 663077p
FB-Gericht: Landesgericht Innsbruck

Sitz: 6421 Rietz
Hintere Gasse 5e | Austria

Mitglied der WKÖ

Bezirkshauptmannschaft Imst

Contact

Phone: +43699 17243420
E-Mail: contact (at) radiant-pixel.com