ZPLからTSPLへの変換：コマンド対応表と移行ガイド（Zebra → TSC）

ZPLコマンドがTSPLにどう対応するか、単位・フォント・バーコードで何が変わるか、実際のラベルの変換前後、そしてZebraのラベルライブラリを再デザインなしでTSCプリンタへ移行する方法。

ZebraからTSCへの移行は、物流と小売で最も多いプリンタ移行です。TSC機は価格が低く、機構は同じラベルとリボンに対応します。障壁は言語です。ZPLとTSPLは同じもの — 位置指定のテキスト、バーコード、枠 — をまったく異なる構文で記述するため、何かが翻訳してくれない限り、既存のZPLテンプレートはすべて書き直しになります。

コマンド対応表

操作	ZPL（Zebra）	TSPL（TSC）
ラベルの開始／終了	^XA … ^XZ	CLS … PRINT 1
ラベルサイズ	^PW800 ^LL600（ドット）	SIZE 100 mm,75 mm GAP 3 mm,0
フィールド位置	^FO50,40（x,y ドット）	TEXT/BARCODE の最初の2パラメータ（x,y ドット）
テキスト	^A0N,40,40 ^FDHello^FS	TEXT 50,40,"0",0,12,12,"Hello"
Code 128	^BY2 ^BCN,80,Y,N,N ^FD12345^FS	BARCODE 50,150,"128",80,1,0,2,4,"12345"
QRコード	^BQN,2,6 ^FDQA,data^FS	QRCODE 400,150,M,6,A,0,"data"
Data Matrix	^BXN,6,200 ^FDdata^FS	DMATRIX 400,150,120,120,"data"
枠／線	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
枚数	^PQ10	PRINT 10,1
濃度／速度	^MD15 ^PR4	DENSITY 10 SPEED 4

実際に変わるもの

単位：ZPLはドットのみで動作します。TSPLはSIZEとGAPでミリメートルまたはインチを受け付けますが、位置はドットです。203 dpiのZPLテンプレートを300 dpiのTSCプリンタに移す場合、すべての座標を1.48倍にする必要があります。
フォント：ZPLの^A0はドット単位で指定するスケーラブルフォントです。TSPLの内蔵フォント1〜8は整数倍率の固定ビットマップで、フォント"0"はスケーラブルですが1文字あたりのドット数で指定します。テキスト幅は完全には一致しません — 製品名が長いラベルを確認してください。
バーコードのパラメータ：ZPLは^BYでモジュール幅を一度設定して再利用します。TSPLはBARCODEコマンドごとに細バーと太バーの幅を宣言します。可読文字はどちらもフラグですが、フォントと位置が異なります。
原点と向き：どちらも左上隅を使いますが、TSPLのDIRECTIONとREFERENCEは(0,0)の位置を変えます。すべてのジョブで明示的に設定してください。
グラフィック：ZPLの^GF 16進ビットマップとTSPLのBITMAPはバイト順と極性が異なります。ロゴはコピーではなく再エンコードが必要です。
RFID：^RFコマンドはRFID非対応のTSC機には相当するものがありません。RFID対応のTSC機ではコマンド体系が異なり、エンコードを再定義する必要があります。

変換前と変換後：同じラベル

^XA
^PW812 ^LL609
^FO40,30 ^A0N,36,36 ^FDSafety Harness^FS
^FO40,80 ^A0N,24,24 ^FDLOT: MX-24-0917^FS
^FO40,130 ^BY2 ^BCN,90,Y,N,N ^FD7501234567893^FS
^PQ1
^XZ

SIZE 101.6 mm,76.2 mm
GAP 3 mm,0
DIRECTION 1
CLS
TEXT 40,30,"0",0,11,11,"Safety Harness"
TEXT 40,80,"0",0,7,7,"LOT: MX-24-0917"
BARCODE 40,130,"128",90,1,0,2,4,"7501234567893"
PRINT 1,1

ラベルサイズが物理単位になり、各フィールドが独自の座標を持ち、バーコードがバー幅をインラインで宣言している点に注目してください。データ — 製品、ロット、GTIN — はそのままで、外側だけが変わりました。

移行チェックリスト

座標をスケーリングする前にプリンタ解像度（203か300 dpiか）を確認する。
各テンプレートをTSC機で一度印刷し、バーコードを検証する（ISO 15416）。グレードが下がる場合は細バー幅を調整する。
長い可変テキストがはみ出さないことを確認する — TSPLフォントは同じ公称サイズで幅が広い。
ロゴをTSPLビットマップとして再エンコードするか、できればデザインツール内でベクターオブジェクトのまま保持する。
ZPL版をライブラリに残す：移行期間中は混在フリートが通常です。

EtikStudioでの方法

ZPLファイルを貼り付けるかインポートすると、インタプリタがミリメートル単位の編集可能なデザインとして描画します。TSCプリンタのプロファイルを選んでエクスポートすると、EtikStudioは対象解像度にスケーリングした座標、メトリクスの一致するフォント、モジュール単位で再構築したバーコード、再エンコードしたロゴを含むTSPLを生成します。同じデザインが、最後の1台が退役するまでZebra機でも印刷を続けます。

コマンド例は分かりやすさのため簡略化しています。正確な構文はプリンタの機種とファームウェアにより異なります。必ず対象プリンタでテストしてください。