ZPL とは: 構造、単位、基本のラベル

ZPL (Zebra Programming Language) は、Zebra をはじめとする多くのサーマルラベルプリンター (ZPL II エミュレーション: CAB、Novexx など) で使われるプリンター言語です。ラベルは コマンド (^ コマンドと ~ コマンド) で構成されたテキスト文書です。

ラベルの構造

すべてのラベルは ^XA (フォーマット開始) で始まり、^XZ (フォーマット終了) で終わります:

^XA
^FO50,50^FDHello World^FS
^XZ

• ^FO50,50 はフィールド原点 (位置) で、x=50 ドット、y=50 ドットを指します
• ^FDHello World はフィールドデータ (印字するテキスト) です
• ^FS はフィールドセパレーター (フィールドの終わり) です

単位: ドット、mm、DPI

ZPL の位置とサイズはすべて ドット 単位です。物理的なサイズはプリンターの解像度 (DPI = 1 インチあたりのドット数) によって決まります:

DPI	1 mm あたりのドット数
203	8.0
300	11.8
600	23.6

dots = mm × DPI / 25.4

例: 203 dpi で 75 mm のラベルなら、75 × 203 / 25.4 = 600 ドット 幅になります。

動作する最小の例

^XA
^PW600          ; label width in dots (75 mm @ 203 dpi)
^LL400          ; label length in dots (50 mm @ 203 dpi)
^FO50,50^A0N,30,30^FDHello ZplCloud^FS
^XZ

ヒント

• コマンドは大文字と小文字を区別しません (^xa は ^XA と同じように動作します)。
• サポートされていないコマンドは、ほとんどのプリンターで警告なく無視されます。まず ZPL リンターで検証してください。
• テキストは必ず ^FS で終わらせてください。^FS がないと次のコマンドが飲み込まれます。