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, orientation N (normale, non pivotée), hauteur 40 points, largeur 40 points.
  • ^FD — field data : introduit le contenu du champ. Tout ce qui précède ^FS est 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.

  • ^FS oublié : 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 ^PW812 mais ^FO900,..., l'élément ne s'imprimera pas. Vérifiez toujours les valeurs par rapport à ^PW et ^LL.
  • Police non disponible sur l'imprimante : la police 0 est 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 ^CI28 au 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 ^FO ou réduisez la largeur du module.

Ressources externes