TSPL Command Reference

Every command the Labelixa TSPL preview understands, with syntax, an example and its honest support status. Commands outside this list are reported by the validator as unknown.

This tool renders NATIVE TSPL. Many TSC printers also offer manufacturer-documented ZPL emulation — that is a separate mode; for ZPL code use the ZPL viewer.

Coverage: 7 commands supported, 3 partially supported, 7 recognized as printer-behaviour (not drawn). The preview renders at 203 dpi and is an interpretation of the TSPL/TSPL2 programming manual — it has not been verified against a physical printer.

Command	Syntax	Status	Description
`SIZE`	`SIZE <w> mm, <h> mm` `SIZE 100 mm, 150 mm`	Supported	Label size; with mm suffix in millimetres, without a unit in inches.
`GAP`	`GAP <g> mm, <o> mm` `GAP 3 mm, 0 mm`	Supported	Gap between labels — affects the physical feed, recorded but not drawn.
`REFERENCE`	`REFERENCE x, y` `REFERENCE 0, 0`	Supported	Shifts the origin; applied to all following coordinates in the preview.
`CLS`	`CLS` `CLS`	Supported	Clears the image buffer; typical start of every TSPL job.
`TEXT`	`TEXT x, y, "font", rot, xm, ym, "content"` `TEXT 100, 100, "3", 0, 1, 1, "HELLO"`	Partial	Text field. Built-in fonts 0-8; other font names (TSS24.BF2…) are approximated by the number in their name.
`BARCODE`	`BARCODE x, y, "type", h, readable, rot, n, w, "data"` `BARCODE 100, 200, "128", 100, 1, 0, 3, 3, "123456"`	Partial	Barcode field. MVP types: 128, 39, EAN13, UPCA. Other types are skipped with a warning.
`QRCODE`	`QRCODE x, y, ecc, cell, mode, rot, "data"` `QRCODE 100, 400, M, 6, A, 0, "https://..."`	Partial	QR code with ECC level L/M/Q/H and cell width.
`BOX`	`BOX x1, y1, x2, y2, t` `BOX 40, 40, 760, 400, 4`	Supported	Box outline between two corners with a border thickness.
`BAR`	`BAR x, y, w, h` `BAR 50, 500, 700, 4`	Supported	Filled black bar.
`PRINT`	`PRINT n[, copies]` `PRINT 1`	Supported	Print — sets set count (and copies).
`DIRECTION`	`DIRECTION n[, m]` `DIRECTION 1`	Printer-only	Print direction — not applied to the MVP preview.
`DENSITY`	`DENSITY n` `DENSITY 8`	Printer-only	Darkness — printer behaviour, no image effect.
`SPEED`	`SPEED n` `SPEED 4`	Printer-only	Print speed — printer behaviour, no image effect.
`OFFSET`	`OFFSET <o> mm` `OFFSET 0 mm`	Printer-only	Feed offset — printer behaviour.
`SET`	`SET <opt> <val>` `SET TEAR ON`	Printer-only	Printer option switches (TEAR, PEEL…) — printer behaviour.
`CODEPAGE`	`CODEPAGE n` `CODEPAGE 1252`	Printer-only	Character set selection — the preview assumes UTF-8.
`BLINE`	`BLINE <b> mm, <o> mm` `BLINE 3 mm, 0 mm`	Printer-only	Black-mark spacing — feed calibration, not drawn.

Render your code: TSPL viewer

English Türkçe Deutsch

Feedback

Something wrong? Tell us.

Your label content is NOT sent; only your message, the page you are on and the build version.