ZPL-Befehlsliste und -Referenz
Vollständige ZPL-Befehlsliste nach Aufgabe: Format und Position, Text und Schriften, Barcodes, Grafik, Medien. Syntax, Parameterbereiche, lauffähige Beispiele.
So ist ein ZPL-Format aufgebaut
Jedes Etikett beginnt mit ^XA und endet mit ^XZ. Dazwischen besteht jedes Feld aus drei Teilen: Position (^FO x,y), Inhalt (^FD…^FS) und einem optionalen Formatbefehl (Schrift ^A, Barcode ^BC). Koordinaten sind Druckerpunkte, keine Millimeter — bei 203 DPI ist ein Zoll 203 Punkte.
^XA
^FO50,50^A0N,40,40^FDHello^FS
^FO50,110^BY2^BCN,80,Y,N,N^FD12345678^FS
^XZZPL-Befehlsliste nach Aufgabe
Die Befehle, die jede Aufgabe braucht, einer pro Zeile. Jeder Link öffnet die Seite des Befehls mit Syntax, Parameterbereichen und Beispiel; die druckbare Fassung dieser Liste ist das ZPL-Cheat-Sheet.
Format und Position
Etikett öffnen und schließen, jedes Feld beenden und platzieren: ^FO ab der linken oberen Ecke, ^FT ab der Text-Grundlinie; ^LH, ^LS und ^LT verschieben das ganze Etikett.
^XAFormatbeginn^XZFormatende^FSFeldtrenner^FOFeldursprung^FTFeld-Grundlinie^LHEtiketten-Nullpunkt^LSEtikett verschieben^LTEtikett nach oben^FXKommentar
Text und Schriften
Felddaten, Schrift und Größe, Standardschrift, Zeichensatz (^CI28 für UTF-8), umbrechende Textblöcke, Hex-Escapes, Drehung und Inversdruck.
^FDFelddaten^ASchriftauswahl^CFStandardschrift^CIZeichensatz^FBTextblock^TBTextblock (Breite und Höhe)^FHHexadezimal-Kennzeichen^FWFeldausrichtung^FRInvertierter Druck^FVVariables Feld^PAErweiterte Texteigenschaften^CWSchriftkennung
Barcodes
^BY setzt Modulbreite und Standardhöhe für den folgenden Barcode; danach ein Befehl pro Symbologie, 1D und 2D.
^BYBarcode-Standardwerte^BCCode 128^BEEAN-13^BQQR-Code^BXData Matrix^B3Code 39^B7PDF417^B1Code 11^B2Interleaved 2/5^B8EAN-8^B9UPC-E^BACode 93^BIIndustrial 2/5^BJStandard 2/5^BKCodabar^BMMSI^BUUPC-A^BRGS1 DataBar^B0Aztec^BOAztec^BFMicroPDF417^BDMaxiCode
Grafik und Bilder
Rahmen und Linien (^GB), Kreise, Ellipsen, Diagonalen, eingebettete Bitmaps (^GF) und im Druckerspeicher abgelegte Grafiken.
^GBGrafikbox^GCGrafikkreis^GDDiagonale Linie^GEGrafikellipse^GFGrafikfeld^IMBild platzieren^DGGrafik laden^XGGrafik aufrufen
Medien und Druckereinrichtung
Etikettenbreite und -länge, Druckausrichtung, Inversdruck des ganzen Etiketts, Maßeinheiten und Anzahl der Kopien.
^PWDruckbreite^LLEtikettenlänge^PODruckausrichtung^PMSpiegelbild des Etiketts drucken^LREtikett invertieren^MUMaßeinheit festlegen^PQDruckmenge
Eine druckbare Ein-Seiten-Zusammenfassung ist das ZPL-Cheat-Sheet; zum sofortigen Ausprobieren der Online-ZPL-Viewer. ZPL-Cheat-Sheet · Online-ZPL-Viewer
Formatsteuerung
Formatbeginn
Kennzeichnet den Anfang eines Etikettenformats. Jedes Etikett beginnt mit ^XA.
^XZFormatende
Beendet das Etikettenformat und druckt bzw. rendert das Etikett.
^FSFeldtrenner
Beendet ein Feld. Jedes ^FD-, ^GB- oder Barcode-Feld wird mit ^FS abgeschlossen.
^FXKommentar
Ein Kommentar. Er hat keine Wirkung auf das Rendern und wird übersprungen.
^CFStandardschrift
Legt Schrift, Höhe und Breite für die folgenden ^FD-Felder fest.
^CIZeichensatz
Wählt die internationale Zeichenkodierung. Die Engine setzt UTF-8 voraus (^CI28).
^PWDruckbreite
Legt die Druckbreite des Etiketts in Punkten fest.
^LLEtikettenlänge
Legt die Etikettenlänge in Punkten fest.
^LHEtiketten-Nullpunkt
Verschiebt den Referenzpunkt der linken oberen Ecke (Home) des Etiketts.
^LT ·Etikett nach oben
Verschiebt das gesamte Etikett senkrecht.
^PODruckausrichtung
Wählt die Druckausrichtung: ^POI druckt das gesamte Etikett um 180° gedreht. Die Vorschau zeichnet es ebenfalls gedreht.
^LREtikett invertieren
Druckt folgende Felder invertiert (negativ); ^LRN schaltet es aus.
^LSEtikett verschieben
Verschiebt ALLE Felder horizontal. Versandetiketten tragen meist ^LS0 (ohne Wirkung); ein Wert ungleich null verschiebt jedes Feld.
^PMSpiegelbild des Etiketts drucken
Spiegelt den gesamten druckbaren Bereich von links nach rechts; bleibt bis ^PMN aktiv. Die Vorschau zeichnet das Spiegelbild ebenfalls.
^CCFormatpräfix ändern
Ändert das Präfix der Formatbefehle (^) in ein anderes Zeichen (auch ~CC); Vorschau und Prüfung wenden das neue Präfix an.
^CTSteuerpräfix ändern
Ändert das Präfix der Steuerbefehle (~) in ein anderes Zeichen; auch als ~CT geschrieben. Vorschau und Prüfung wenden die Änderung an.
Positionierung und Text
Feldursprung
Setzt das nächste Feld auf die Position x,y, gemessen von der linken oberen Ecke.
^FTFeld-Grundlinie
Positioniert das nächste Feld an der Grundlinie des Textes statt an seiner Oberkante.
^FDFelddaten
Enthält den zu druckenden Text oder die Barcode-Daten.
^FHHexadezimal-Kennzeichen
Aktiviert _XX-Hex-Escapes im folgenden ^FD (für Sonderzeichen).
^A ·Schriftauswahl
Wählt Schrift, Ausrichtung und Größe. ^A0 ist die skalierbare Schrift.
^FBTextblock
Setzt Text als umbrechenden Block fester Breite, einschließlich Ausrichtung.
^FWFeldausrichtung
Legt die Standarddrehung für die folgenden Felder fest (N/R/I/B).
^FRInvertierter Druck
Druckt das nächste Feld invertiert: hell auf dunklem Grund.
^FVVariables Feld
Trägt Felddaten als Variable; die Engine behandelt es genauso wie ^FD.
^TBTextblock (Breite und Höhe)
Setzt Text mit Umbruch in einen Block fester Breite und Höhe; was nicht passt, wird abgeschnitten statt wie bei ^FB überdruckt.
^PAErweiterte Texteigenschaften
Steuert fehlende Zeichen, bidirektionales Layout, Zeichenformung und OpenType; die Vorschau wendet die letzten drei gemeinsam an.
^CWSchriftkennung
Bindet einen Schriftbuchstaben (A-Z, 0-9) an eine geladene Schrift. Die Vorschau nutzt nur per ~DU im selben ZPL gesendete TrueType-Schriften.
Grafik
Grafikbox
Zeichnet ein Rechteck oder eine Linie (Breite, Höhe, Stärke).
^GCGrafikkreis
Zeichnet einen Kreis (Durchmesser, Stärke).
^GDDiagonale Linie
Zeichnet eine diagonale Linie.
^GEGrafikellipse
Zeichnet eine Ellipse (Breite, Höhe, Stärke).
^GFGrafikfeld
Druckt eine im Etikett eingebettete Bitmap-Grafik (Logo oder Bild).
^IMBild platzieren
Platziert eine Grafik aus dem Speicher an der aktuellen ^FO-Position (leistet dasselbe wie ^XG).
Barcodes
Barcode-Standardwerte
Legt Modulbreite, Verhältnis und Höhe für die folgenden Barcodes fest.
^BCCode 128
Ein Code-128-Barcode — der häufigste lineare Barcode in Versand und Logistik.
^BEEAN-13
Ein EAN-13-Handelsbarcode (die letzte Ziffer wird automatisch berechnet).
^BQQR-Code
Ein QR-Code. Die Daten werden üblicherweise mit dem Präfix ^FDQA,... angegeben.
^BXData Matrix
Ein Data-Matrix-2D-Barcode — viele Daten auf sehr kleiner Fläche.
^B3Code 39
Code 39 — ein linearer Barcode für Großbuchstaben und Ziffern.
^B7PDF417
Ein gestapelter PDF417-Barcode — hohe Datenmenge auf mehreren Zeilen.
^B1Code 11
Code 11 (USD-8) — Telekom- und Laboretiketten.
^B2Interleaved 2/5
Interleaved 2 of 5 — numerische Daten in Ziffernpaaren.
^B8EAN-8
EAN-8 — kurzer Handelscode für kleine Verpackungen.
^B9UPC-E
UPC-E — komprimierter UPC für kleine Verpackungen.
^BACode 93
Code 93 — der dichtere Nachfolger von Code 39.
^BIIndustrial 2/5
Industrial 2 of 5 — nur numerisch, industriell.
^BJStandard 2/5
Standard 2 of 5 — nur numerisch.
^BKCodabar
Codabar — Blutbanken, Bibliotheken, Kurieretiketten.
^BMMSI
MSI Plessey — Regal- und Inventaretiketten.
^BUUPC-A
UPC-A — der nordamerikanische Handelsstandard.
^BRGS1 DataBar
GS1 DataBar (RSS Expanded) — kleiner Handel und Frischware.
^B0Aztec
Aztec Code — 2D, benötigt keine Ruhezone.
^BOAztec
Aztec Code (Schreibweise ^BO) — erzeugt dieselbe Symbologie wie ^B0.
^BFMicroPDF417
MicroPDF417 — PDF417 komprimiert für schmalen Raum.
^BDMaxiCode
MaxiCode — die Symbologie auf UPS-Versandetiketten.
Fortgeschritten
Serialisierung
Serialisiert die Felddaten über eine Auflage hinweg mit Startwert, Schrittweite und Auffüllung.
^PQDruckmenge
Legt fest, wie viele Kopien desselben Etiketts erzeugt werden.
^MU ·Maßeinheit festlegen
Wählt die Einheit für die folgenden Befehle; mit Ausgangs- und Zielpunktdichte skaliert der Drucker das Format zwischen zwei Auflösungen.
^FNFeldnummer
Platzhalter für ein variables Feld in Vorlagen (zusammen mit ^DF und ^XF).
^DFFormat speichern
Speichert ein Etikettenformat als Vorlage im Speicher.
^XFFormat aufrufen
Ruft eine gespeicherte Vorlage auf und füllt ihre ^FN-Felder mit Werten.
^XGGrafik aufrufen
Ruft eine in den Speicher geladene Grafik (~DG oder ^GF) auf und druckt sie.
~DGGrafik laden
Lädt eine Bitmap-Grafik in den Druckerspeicher (ein Steuerbefehl mit dem Präfix ~).
^DUSchrift herunterladen
Lädt eine TrueType-Schrift in den virtuellen Druckerspeicher; mit ^A@ gebundene Felder nutzen diese Daten.
^DYObjekt herunterladen
Lädt ein Grafik- oder Schriftobjekt in den virtuellen Druckerspeicher (die allgemeine Form von ^DG).
^EGGrafiken löschen
Löscht ALLE Grafiken aus dem virtuellen Druckerspeicher.
^IDObjekt löschen
Löscht EIN einzelnes Objekt aus dem Speicher (^EG löscht alle).
^SFFeld-Serialisierung
Erhöht Felddaten automatisch anhand einer Maske (die maskenbasierte Form von ^SN).
Labelixa-Erweiterung (Vorschau)
RFID
RFID Lesen/Schreiben
Schreibt Daten auf das RFID-Tag oder liest sie. Das Vorschaubild bleibt unverändert; die Kodierung übernimmt ein echter RFID-Drucker.
^RS ·RFID-Einrichtung
Konfiguriert RFID-Tag-Typ, Programmierposition und Fehlerbehandlung.
^RB ·EPC-Bit-Partitionen
Definiert die Bit-Partitionen der EPC-Daten; nachfolgende ^RF-Schreibvorgänge nutzen dieses Layout.
^RR ·RFID-Wiederholungen
Legt die Anzahl der Wiederholungen für fehlgeschlagene RFID-Lese-/Schreibvorgänge fest.
Druckereinstellungen
ZPL-Modus wählen
Legt fest, ob der Drucker ZPL oder ZPL II interpretiert. Eine Druckereinstellung; ohne Wirkung auf die Vorschau.
~TA ·Abreißposition anpassen
Verschiebt die Ruheposition des Mediums nach dem Druck (Abriss- oder Schnittkante) in Punktzeilen, dreistellig. Ohne Wirkung auf die Vorschau.
^ML ·Maximale Etikettenlänge
Legt die maximale Etikettenlänge für die Kalibrierung fest; sie muss mindestens der echten Länge entsprechen. Ohne Wirkung auf die Vorschau.
^MC ·Bitmap löschen
^MCN behält das Bitmap, das Etikett erscheint hinter dem nächsten. Die Vorschau zeichnet jedes Etikett sauber und warnt bei ^MCN.
~PS ·Druck fortsetzen
Lässt einen pausierten Drucker weiterdrucken (wie PAUSE am Bedienfeld). Ohne Wirkung auf die Vorschau.
~JO ·Kopftest nicht fatal
Bei fehlgeschlagenem Kopftest Fehler und Druckstopp, aber ohne Aus- und Einschalten (anders als ~JN). Ohne Wirkung auf die Vorschau.
^SP ·Druck vorzeitig starten
Startet bei komplexen Etiketten den Druck ab einer Punktzeile, bevor das Format fertig ist. Ohne Wirkung auf die Vorschau.
^ZZ ·Druckerruhezustand
Schaltet einen akkubetriebenen Drucker nach der angegebenen Leerlaufzeit ab (nur PA400/PT400). Ohne Wirkung auf die Vorschau.
~EF ·Formate löschen (veraltet)
Veralteter ZPL-II-Befehl, der gespeicherte Formate löscht; das aktuelle Zebra-Handbuch nutzt ^ID. Ohne Wirkung auf die Vorschau.