^FB — Field Block
Plain English
Creates a text box with automatic word wrapping inside a fixed width. The printer breaks the text into lines and renders up to the configured maximum — **any text past `lines` is truncated, not overflowed**, so undersized blocks silently drop content.
When to use
For wrapped content where the box dimensions are known up-front (addresses, descriptions, compliance text). Set `lines` generously and verify wrapping with realistic worst-case data, otherwise long inputs will be silently cut.
Syntax
^FBw,lines,space,align,indent
Parameters
| Parameter | Description |
|---|---|
w | Width of the text block in dots |
lines | Maximum number of lines (extra lines are truncated, not overflowed) |
space | Extra space between lines in dots (0 = auto from font) |
align | L (left), C (centre), R (right), J (full-justified) |
indent | Hanging indent in dots — applied to lines 2..n only (not line 1) |
Example
^XA ^FO50,50^A0N,22,22 ^FB400,3,5,C,0 ^FDThis is a long description that will wrap within 400 dots, centred, max 3 lines. Anything past three lines is dropped.^FS ^XZ
3-line max, centre-justified. Worth confirming wrapping with realistic worst-case input.