BLOCK - Text Block (auto-wrap)
Plain English
Draws a multi-line text block with automatic word-wrap inside a width × height bounding box. Like TEXT but words break at whitespace once they would exceed `width`, and the engine clips at `height` once `floor(height / fontHeight)` lines have been laid out. BLOCK is a TSPL2 firmware addendum (TX/TE/MH-series) — not in the 2009 PG.
When to use
When you have variable-length text (description fields, multi-line addresses, product details) that needs to fit a fixed area without manual line-splitting. For single-line text use TEXT; for filled bars use BAR.
Syntax
BLOCK x,y,width,height,"font",rotation,x-mul,y-mul,"data"
Parameters
| Parameter | Description |
|---|---|
x | Top-left X coordinate of the bounding box in dots |
y | Top-left Y coordinate of the bounding box in dots |
width | Width of the wrap region in dots — words wrap when they would exceed this |
height | Height of the wrap region in dots — clipped after floor(height/fontHeight) lines |
font | Font identifier in double quotes (same set TEXT accepts: "0"–"8", "ROMAN.TTF", etc.) |
rotation | 0, 90, 180, or 270 degrees |
x-mul | Horizontal magnification (1–10) |
y-mul | Vertical magnification (1–10) |
data | The text to render in double quotes; spaces are wrap points |
Example
BLOCK 50,50,300,120,"3",0,1,1,"Long description that wraps automatically"
A 300×120 dot text block at (50,50), font "3", auto-wrapping the description