Skip to content
ArcBrush ArcBrush Docs

Text

Node icon
Generator

Renders text to an image with full font, color, alignment, and layout control. Supports system fonts or custom .ttf/.otf files.

The Text node renders text strings into an image using either system-installed fonts or a custom .ttf/.otf file. Choose from any installed font family and weight, set the size in pixels, and pick a color. Multi-line text, letter spacing, and line spacing are all supported.

Layout controls let you position the text precisely within the canvas using horizontal and vertical alignment plus pixel or percentage offsets. Rotation lets you angle the text around its anchor point. When a background image is connected, the text composites directly on top, or you can output just the text layer by itself.

Parameters

Section titled “Parameters”

Pins

BackgroundImage
InputOptional
ImageImage
Output

Text

TextText
Default: Text

The string to render. Multi-line input is supported

Font Size (px)Number
Default: 96.0 Range: 1.0–1024.0

Text size in pixels

ColorColor (RGBA)
Default: rgba(255, 255, 255, 255)

Text color

Font

Font FamilyText

System font family (dynamic list from installed fonts)

WeightText

Font weight/style variant (dynamic list based on Font Family)

Custom FontText

Path to a .ttf/.otf font file. Overrides family selection when set

HintingChoice
Default: None

Font hinting mode. None: smooth (best for large text). Light: subtle grid-fit. Full

  • NoneNo hinting — text renders with pure outline shapes. Smoothest at large sizes.
  • LightSubtle grid-fitting for improved clarity without distorting letterforms.
  • FullMaximum grid-fitting for the sharpest text at small sizes. May slightly alter letter shapes.

Layout

AlignmentChoice
Default: Center

Horizontal alignment of text within its bounds

  • LeftAlign text to the left edge.
  • CenterCenter text horizontally.
  • RightAlign text to the right edge.
Vertical AlignChoice
Default: Middle

Vertical alignment of text within its bounds

  • TopAlign text to the top edge.
  • MiddleCenter text vertically.
  • BottomAlign text to the bottom edge.
Position XInteger · px/%
Default: 50 Range: 0–8192 px / 0–100%

Horizontal anchor position. Default is % mode at 50% (center)

Position YInteger · px/%
Default: 50 Range: 0–8192 px / 0–100%

Vertical anchor position. Default is % mode at 50% (middle)

RotationNumber
Default: 0.0 Range: -360.0–360.0

Rotate text around the anchor point. Values are in degrees (-360 to 360)

Line SpacingNumber
Default: 1.00 Range: 0.50–3.00

Multiplier for vertical line spacing

Letter Spacing (px)Integer
Default: 0 Range: -50–200

Extra horizontal spacing between characters

Output

Width (px)Integer
Default: 512 Range: 1–8192
When background input is not connected

Output width

Height (px)Integer
Default: 512 Range: 1–8192
When background input is not connected

Output height

Output ModeChoice
Default: Composite
When background input is connected

Text Only: text on transparent background. Composite

  • Text OnlyOutput only the rendered text on a transparent background.
  • CompositeRender text composited onto the connected background image.
Blend ModeChoice
Default: 0 Range: Normal / Multiply / Screen / Overlay / Linear Dodge (Add) / Subtract / Difference / Hard Light / Soft Light / Darken / Lighten / Color Dodge / Color Burn / Exclusion / Hue / Saturation / Color / Luminosity
Composite mode only

Blend mode when compositing over background

OpacityNumber
Default: 1.00 Range: 0.00–1.00
Composite mode only

Composite opacity

Usage Tips

Section titled “Usage Tips”
  • Use a custom font file (.ttf/.otf) for consistent results across machines, since system fonts may differ.
  • Set alignment to Center + Middle and position to 50%/50% for perfectly centered text.
  • Use Letter Spacing to create a wide-tracked heading style.
  • Connect a background image and set Output Mode to Composite to render text directly onto it.
  • In Composite mode, use Blend Mode and Opacity to control how text mixes with the background (e.g., Multiply for watermarks).
  • Set Hinting to None for smooth large display text; use Full for maximum crispness at small sizes.
Section titled “Related Nodes”