DocumentationSubstance 3D

Text

Last update: Thu Feb 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
Atomic node: Text{width="200px"}

The Text node provides a way to place-user created text in your graphs. Users can also select settings like Font, Alignment and rotation to customize the text placement.

The Text node is very powerful and the only way to easily place text. It can be a bit tricky to use due to placement always happening on a limited, square canvas, and fonts being driven by a system-defined external list.

Only Truetype (.ttf) and certain Opentype fonts are supported. If any fonts are missing from the list, this is probably the reason. Fonts can not be exposed as a parameter.

When a Graph using Text is published to sbsar, the font is embedded into the package, just like with bitmaps and other resources, to ensure it works across all systems and applications.

Output connectors

Examples

Parameters

Color mode Boolean
Toggles between a grayscale and a color output image.
Text String
Determines the text description.
Font String
The font resource used to render the text.
Font size Float
The font size for the text in points.
Alignment Integer
Sets the text alignment as left, center (default) or right.
Transformation Float4
The 2x2 transformation matrix applied to the rendered text.
Position Float2
The position of the text in the output image.
Background Float/Float4
The output image’s background color.
Font color Float/Float4
The color of the text.

Input connectors

Background Grayscale/Color PRIMARY
The output image’s background color.

Output connectors

Output Grayscale/Color

Examples

Coming soon.

recommendation-more-help
dd48abc6-e399-43d2-9777-578ec70c5a23