Guide de démarrage rapide ZPL
Guide de démarrage rapide ZPL
Qu'est-ce que le ZPL
Le ZPL (Zebra Programming Language) est un langage textuel permettant de piloter les imprimantes thermiques Zebra et compatibles. Une étiquette ZPL n'est qu'un bloc de texte : elle s'ouvre par ^XA, se ferme par ^XZ, et entre les deux vous déclarez des éléments graphiques, du texte et des codes-barres.
L'avantage est que le « fichier » est lisible par un humain, versionnable et modifiable à la main. Aucun format propriétaire : un simple éditeur de texte suffit pour produire une étiquette prête à imprimer.
Hello world
^XA
^FO50,50^A0N,40,40^FDHello World^FS
^XZ
C'est tout. Envoyé à une imprimante Zebra (ou à une visionneuse comme Labelary), cela produit une étiquette avec « Hello World » imprimé en haut à gauche.
Anatomie d'une étiquette
Ligne par ligne, l'exemple ci-dessus se lit ainsi :
^XA— start format : marque le début de l'étiquette. Tout ce qui suit fait partie de l'étiquette en cours.^FO50,50— field origin : place l'élément suivant à 50 points de la marge gauche et à 50 points du haut.^A0N,40,40— police : sélectionne la police 0, orientationN(normale, non pivotée), hauteur 40 points, largeur 40 points.^FD— field data : introduit le contenu du champ. Tout ce qui précède^FSest le texte à imprimer.^FS— field separator : ferme le champ. L'oublier est l'une des erreurs les plus fréquentes : l'analyseur avalera les commandes suivantes comme des données.^XZ— end format : ferme l'étiquette.
Commandes essentielles
| Commande | Ce qu'elle fait |
|---|---|
^XA / ^XZ |
Ouvre / ferme le format d'étiquette |
^PW |
Largeur d'impression (points) |
^LL |
Longueur de l'étiquette (points) |
^LH |
Décale l'origine logique de l'étiquette |
^CI28 |
Définit l'encodage UTF-8 (indispensable pour les accents) |
^FO x,y |
Positionne l'élément suivant |
^A0N,h,w |
Police vectorielle 0, hauteur/largeur en points |
^FD ... ^FS |
Délimite le champ de données |
^BC |
Code-barres Code 128 |
^BQ |
Code QR |
^GB w,h,t |
Cadre ou ligne (largeur, hauteur, épaisseur) |
^GF |
Image bitmap en niveaux de gris |
^FX |
Commentaire (ignoré par l'imprimante) |
Système de coordonnées
Le ZPL raisonne en points (les points imprimables individuels), pas en millimètres. La conversion dépend de la résolution de l'imprimante :
dot = mm * DPI / 25.4
Exemples pratiques :
- 50 mm à 203 dpi ≈ 400 points
- 50 mm à 300 dpi ≈ 591 points
- 100 mm à 203 dpi ≈ 800 points
L'origine (0,0) est le coin supérieur gauche. Une imprimante 203 dpi avec des étiquettes de 4 pouces utilise généralement ^PW812.
Variables dynamiques
Dans ZPL Archive, nous utilisons la notation {{name}} pour les champs qui sont remplacés à la volée. Exemple d'une étiquette d'expédition paramétrique :
^XA
^CI28
^FO30,30^A0N,28,28^FDRecipient:^FS
^FO30,70^A0N,36,36^FD{{customer_name}}^FS
^FO30,120^A0N,28,28^FDTracking:^FS
^FO30,160^BCN,80,Y,N,N^FD{{tracking_number}}^FS
^XZ
L'éditeur de personnalisation lit les {{...}}, affiche un formulaire avec un champ de saisie par variable, et produit le ZPL final avec les valeurs substituées avant de l'envoyer à l'imprimante ou à l'aperçu.
Erreurs courantes
Tout le monde les rencontre au moins une fois. Il vaut la peine d'apprendre à les repérer rapidement.
^FSoublié : les commandes suivantes sont « avalées » par le champ précédent, et l'étiquette ressort vide ou mal alignée.- Coordonnées en dehors de la zone d'impression : avec
^PW812mais^FO900,..., l'élément ne s'imprimera pas. Vérifiez toujours les valeurs par rapport à^PWet^LL. - Police non disponible sur l'imprimante : la police
0est toujours présente, les autres dépendent du firmware. En cas de doute, restez-en à^A0N. - Caractères accentués affichés en
?ou en charabia : il manque^CI28au début de l'étiquette. Ajoutez-le juste après^XA. - Code-barres illisible : généralement la zone de silence (la marge blanche autour) est trop petite. Augmentez le décalage
^FOou réduisez la largeur du module.
Ressources externes
- Guide de programmation ZPL Zebra (PDF officiel) — le manuel de référence complet.
- Visionneuse Labelary — convertit le ZPL en PNG/PDF en ligne, très pratique pour itérer sans imprimer.
- Portail développeurs Zebra — documentation, SDK, exemples.