OFFSET - Form-Feed Offset

Plain English

⚠️ Despite the historical 'OFFSET' name, this is NOT a horizontal coordinate offset — for that, use REFERENCE (origin shift) or SHIFT (vertical translate). TSPL2 §OFFSET p9 defines it as the **selective extra label-feeding length** the printer takes on each form-feed, used in peel-off and cutter modes to adjust where the label stops. The printer back-tracks this extra length before the next print run. Range −1 ≤ m ≤ 1 (inch). Two forms: bare number = inches; followed by ` mm` (with leading space) = millimetres. ⚠️ An out-of-range or otherwise inappropriate value may cause a paper jam. Engine-recognised but no SVG effect today (playground does not simulate the feed/back-feed cycle).

When to use

Only with peel-off or cutter modes when the label stops a few mm short of (or past) the desired position after each print. Pair with `SET PEEL` or `SET CUTTER`.

Syntax

OFFSET m | OFFSET m mm

Parameters

Example

SET PEEL ON
OFFSET 0.1
SIZE 100 mm, 50 mm
CLS
TEXT 50,30,"3",0,1,1,"Peel-mode label"
PRINT 1

Add 0.1 inch extra feeding on each form-feed in peel-off mode