Convertire ZPL in TSPL: equivalenze dei comandi e guida alla migrazione (Zebra → TSC)

Come i comandi ZPL corrispondono al TSPL, cosa cambia in unità, font e codici a barre, un'etichetta reale prima/dopo e come migrare una libreria Zebra su stampanti TSC senza riprogettare.

Passare da Zebra a TSC è la migrazione di stampanti più comune in logistica e retail: le TSC costano meno e la meccanica è compatibile con le stesse etichette e gli stessi nastri. L'ostacolo è il linguaggio. ZPL e TSPL descrivono la stessa cosa — un testo in una posizione, un codice a barre, un riquadro — con sintassi completamente diversa, quindi ogni modello ZPL esistente va riscritto, a meno che qualcosa non lo traduca per voi.

Equivalenze dei comandi

Operazione	ZPL (Zebra)	TSPL (TSC)
Inizio / fine etichetta	^XA … ^XZ	CLS … PRINT 1
Dimensione etichetta	^PW800 ^LL600 (punti)	SIZE 100 mm,75 mm GAP 3 mm,0
Posizione di un campo	^FO50,40 (x,y in punti)	Primi due parametri di TEXT/BARCODE (x,y in punti)
Testo	^A0N,40,40 ^FDCiao^FS	TEXT 50,40,"0",0,12,12,"Ciao"
Code 128	^BY2 ^BCN,80,Y,N,N ^FD12345^FS	BARCODE 50,150,"128",80,1,0,2,4,"12345"
Codice QR	^BQN,2,6 ^FDQA,dati^FS	QRCODE 400,150,M,6,A,0,"dati"
Data Matrix	^BXN,6,200 ^FDdati^FS	DMATRIX 400,150,120,120,"dati"
Riquadro / linea	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
Copie	^PQ10	PRINT 10,1
Intensità / velocità	^MD15 ^PR4	DENSITY 10 SPEED 4

Cosa cambia davvero

Unità: ZPL lavora solo in punti; TSPL accetta millimetri o pollici in SIZE e GAP, ma le posizioni in punti. Un modello ZPL a 203 dpi portato su una TSC a 300 dpi richiede ogni coordinata scalata per 1,48.
Font: l'^A0 di ZPL è un font scalabile dimensionato in punti; i font interni 1–8 di TSPL sono bitmap fissi con moltiplicatori interi, e il font "0" è scalabile ma dimensionato in punti per carattere. Le larghezze del testo non coincideranno esattamente — controllate le etichette con nomi prodotto lunghi.
Parametri dei codici a barre: ZPL imposta la larghezza del modulo una volta con ^BY e la riutilizza; TSPL dichiara la larghezza della barra stretta e larga in ogni comando BARCODE. Il testo leggibile è un flag in entrambi, ma font e posizione differiscono.
Origine e orientamento: entrambi usano l'angolo in alto a sinistra, ma DIRECTION e REFERENCE di TSPL spostano lo (0,0); dichiarateli esplicitamente in ogni lavoro.
Grafica: i bitmap esadecimali ^GF di ZPL e BITMAP di TSPL hanno ordine dei byte e polarità diversi; i loghi vanno ricodificati, non copiati.
RFID: i comandi ^RF non hanno equivalente sui modelli TSC senza RFID; sulle TSC con RFID il set di comandi è diverso e la codifica va ridefinita.

Prima e dopo: la stessa etichetta

^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

Notate come la dimensione dell'etichetta passa in unità fisiche, ogni campo porta le proprie coordinate e il codice a barre dichiara le larghezze delle barre in linea. I dati — prodotto, lotto, GTIN — restano intatti; è cambiato solo l'involucro.

Checklist di migrazione

Confermare la risoluzione della stampante (203 o 300 dpi) prima di scalare le coordinate.
Stampare ogni modello una volta sulla TSC e verificare i codici (ISO 15416); regolare la barra stretta se i gradi calano.
Verificare che i testi variabili lunghi non trabocchino — i font TSPL sono più larghi a parità di dimensione nominale.
Ricodificare i loghi come bitmap TSPL o, meglio, mantenerli come oggetti vettoriali nello strumento di progettazione.
Conservare la versione ZPL in libreria: le flotte miste sono la norma durante una transizione.

Come lo fa EtikStudio

Incollate o importate il file ZPL; l'interprete lo rende come design modificabile in millimetri. Scegliete un profilo stampante TSC ed esportate: EtikStudio rigenera il TSPL con coordinate scalate alla risoluzione di destinazione, font sostituiti con metriche equivalenti, codici ricostruiti per modulo e loghi ricodificati. Lo stesso design continua a stampare sulle Zebra finché l'ultima non viene dismessa.

Gli esempi di comandi sono semplificati per chiarezza; la sintassi esatta varia per modello e firmware. Testa sempre sulla stampante di destinazione.