Convertir ZPL en TSPL : équivalences de commandes et guide de migration (Zebra → TSC)

Comment les commandes ZPL correspondent au TSPL, ce qui change dans les unités, polices et codes-barres, une étiquette réelle avant/après, et comment migrer une bibliothèque Zebra vers des imprimantes TSC sans refonte.

Passer de Zebra à TSC est la migration d'imprimantes la plus courante en logistique et en retail : les TSC coûtent moins cher et leur mécanique est compatible avec les mêmes étiquettes et rubans. L'obstacle, c'est le langage. ZPL et TSPL décrivent la même chose — un texte à une position, un code-barres, un cadre — avec une syntaxe totalement différente, si bien que chaque modèle ZPL existant doit être réécrit, à moins que quelque chose ne le traduise pour vous.

Équivalences de commandes

Opération	ZPL (Zebra)	TSPL (TSC)
Début / fin d'étiquette	^XA … ^XZ	CLS … PRINT 1
Taille de l'étiquette	^PW800 ^LL600 (points)	SIZE 100 mm,75 mm GAP 3 mm,0
Position d'un champ	^FO50,40 (x,y en points)	Deux premiers paramètres de TEXT/BARCODE (x,y en points)
Texte	^A0N,40,40 ^FDBonjour^FS	TEXT 50,40,"0",0,12,12,"Bonjour"
Code 128	^BY2 ^BCN,80,Y,N,N ^FD12345^FS	BARCODE 50,150,"128",80,1,0,2,4,"12345"
Code QR	^BQN,2,6 ^FDQA,données^FS	QRCODE 400,150,M,6,A,0,"données"
Data Matrix	^BXN,6,200 ^FDdonnées^FS	DMATRIX 400,150,120,120,"données"
Cadre / ligne	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
Copies	^PQ10	PRINT 10,1
Noirceur / vitesse	^MD15 ^PR4	DENSITY 10 SPEED 4

Ce qui change réellement

Unités : ZPL ne travaille qu'en points ; TSPL accepte les millimètres ou pouces dans SIZE et GAP, mais les positions en points. Un modèle ZPL 203 dpi porté sur une TSC 300 dpi exige que chaque coordonnée soit multipliée par 1,48.
Polices : le ^A0 de ZPL est une police vectorielle dimensionnée en points ; les polices internes 1–8 de TSPL sont des bitmaps fixes à multiplicateurs entiers, et la police « 0 » est vectorielle mais dimensionnée en points par caractère. Les largeurs de texte ne coïncideront pas exactement — vérifiez les étiquettes aux noms de produit longs.
Paramètres de code-barres : ZPL fixe la largeur de module une fois avec ^BY et la réutilise ; TSPL déclare la barre étroite et la barre large dans chaque commande BARCODE. Le texte lisible est un indicateur dans les deux, mais sa police et sa position diffèrent.
Origine et orientation : les deux utilisent le coin supérieur gauche, mais DIRECTION et REFERENCE de TSPL déplacent le (0,0) ; déclarez-les explicitement dans chaque travail.
Graphiques : les bitmaps hexadécimaux ^GF de ZPL et BITMAP de TSPL ont un ordre d'octets et une polarité différents ; les logos doivent être ré-encodés, pas copiés.
RFID : les commandes ^RF n'ont pas d'équivalent sur les TSC sans RFID ; sur les TSC compatibles RFID, le jeu de commandes diffère et l'encodage doit être redéfini.

Avant et après : la même étiquette

^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

Remarquez comment la taille de l'étiquette passe en unités physiques, comment chaque champ porte ses propres coordonnées et comment le code-barres déclare ses largeurs de barres en ligne. Les données — produit, lot, GTIN — sont intactes ; seule l'enveloppe a changé.

Liste de contrôle de migration

Confirmer la résolution de l'imprimante (203 ou 300 dpi) avant de mettre les coordonnées à l'échelle.
Imprimer chaque modèle une fois sur la TSC et vérifier les codes-barres (ISO 15416) ; ajuster la barre étroite si les notes baissent.
Vérifier que les textes variables longs ne débordent pas — les polices TSPL sont plus larges à taille nominale égale.
Ré-encoder les logos en bitmaps TSPL ou, mieux, les conserver en objets vectoriels dans l'outil de conception.
Conserver la version ZPL dans votre bibliothèque : les parcs mixtes sont la norme pendant une transition.

Comment EtikStudio procède

Collez ou importez le fichier ZPL ; l'interpréteur le rend en design éditable en millimètres. Choisissez un profil d'imprimante TSC et exportez : EtikStudio régénère le TSPL avec des coordonnées mises à l'échelle de la résolution cible, des polices substituées à métriques équivalentes, des codes-barres reconstruits par module et des logos ré-encodés. Le même design continue d'imprimer sur les Zebra jusqu'au retrait de la dernière.

Les exemples de commandes sont simplifiés pour la clarté ; la syntaxe exacte varie selon le modèle et le firmware. Testez toujours sur l'imprimante cible.