ZPL-Schnelleinstieg
ZPL-Schnelleinstieg
Was ZPL ist
ZPL (Zebra Programming Language) ist eine textbasierte Sprache zur Ansteuerung von Zebra- und kompatiblen Thermodruckern. Ein ZPL-Etikett ist nichts anderes als ein Textblock: Er beginnt mit ^XA, endet mit ^XZ, und dazwischen werden grafische Elemente, Texte und Barcodes deklariert.
Der Vorteil: Die "Datei" ist lesbar, versionierbar und von Hand editierbar. Kein proprietäres Format — ein einfacher Texteditor reicht, um ein druckfertiges Etikett zu erzeugen.
Hello world
^XA
^FO50,50^A0N,40,40^FDHallo Welt^FS
^XZ
Das ist alles. An einen Zebra-Drucker (oder einen Viewer wie Labelary) gesendet, erzeugt es ein Etikett mit "Hallo Welt" oben links.
Anatomie eines Etiketts
Zeile für Zeile bedeutet das obige Beispiel:
^XA— start format: markiert den Beginn des Etiketts. Alles, was folgt, gehört zum aktuellen Etikett.^FO50,50— field origin: platziert das nächste Element 50 Dots vom linken und 50 Dots vom oberen Rand.^A0N,40,40— Schriftart: wählt Schrift 0, AusrichtungN(normal, nicht gedreht), Höhe 40 Dots, Breite 40 Dots.^FD— field data: leitet den Feldinhalt ein. Alles bis^FSist der zu druckende Text.^FS— field separator: schließt das Feld. Es zu vergessen ist einer der häufigsten Fehler: Der Parser verschluckt nachfolgende Befehle als Datenteil.^XZ— end format: schließt das Etikett.
Wesentliche Befehle
| Befehl | Wirkung |
|---|---|
^XA / ^XZ |
Öffnet / schließt das Etikettenformat |
^PW |
Druckbreite (Dots) |
^LL |
Etikettenlänge (Dots) |
^LH |
Verschiebt den logischen Etiketten-Ursprung |
^CI28 |
UTF-8-Kodierung (für Umlaute zwingend) |
^FO x,y |
Positioniert das nächste Element |
^A0N,h,w |
Skalierbare Schrift 0, Höhe/Breite in Dots |
^FD ... ^FS |
Umschließt das Datenfeld |
^BC |
Code-128-Barcode |
^BQ |
QR-Code |
^GB w,h,t |
Rechteck oder Linie (Breite, Höhe, Stärke) |
^GF |
Graustufen-Bitmap |
^FX |
Kommentar (vom Drucker ignoriert) |
Koordinatensystem
ZPL rechnet in Dots (einzelnen Druckpunkten), nicht in Millimetern. Die Umrechnung hängt von der Druckerauflösung ab:
dot = mm * DPI / 25.4
Praxisbeispiele:
- 50 mm bei 203 dpi ≈ 400 Dots
- 50 mm bei 300 dpi ≈ 591 Dots
- 100 mm bei 203 dpi ≈ 800 Dots
Ursprung (0,0) ist die obere linke Ecke. Ein 203-dpi-Drucker mit 4-Zoll-Etiketten verwendet typischerweise ^PW812.
Dynamische Platzhalter
Im ZPL Archive verwenden wir die Notation {{name}} für Felder, die zur Laufzeit ersetzt werden. Beispiel eines parametrischen Versandetiketts:
^XA
^CI28
^FO30,30^A0N,28,28^FDEmpfänger:^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
Der Personalisierungs-Editor liest die {{...}}, zeigt ein Formular mit einem Feld pro Platzhalter und erzeugt das finale ZPL mit eingesetzten Werten, bevor es an Drucker oder Vorschau geht.
Häufige Fehler
Passieren jedem mindestens einmal. Es lohnt sich, sie schnell zu erkennen.
- Vergessenes
^FS: Die nachfolgenden Befehle werden vom vorherigen Feld "verschluckt", und das Etikett kommt leer oder verschoben heraus. - Koordinaten außerhalb des Druckbereichs: Bei
^PW812aber^FO900,...wird das Element nicht gedruckt. Werte immer gegen^PWund^LLprüfen. - Schriftart nicht im Drucker vorhanden: Schrift
0ist immer da, alle anderen hängen von der Firmware ab. Im Zweifel^A0Nnutzen. - Umlaute als
?oder kryptische Zeichen:^CI28fehlt am Anfang. Direkt nach^XAeinfügen. - Barcode lässt sich nicht scannen: Meist ist die Quiet Zone (weißer Rand) zu klein.
^FOerhöhen oder Modulbreite reduzieren.
Externe Ressourcen
- Offizieller Zebra-ZPL-Programmierleitfaden (PDF) — das vollständige Referenzhandbuch.
- Labelary Viewer — rendert ZPL online zu PNG/PDF, sehr praktisch zum Iterieren ohne zu drucken.
- Zebra Developer Portal — Dokumentation, SDKs, Beispiele.