Arbeitsbereich
Startseite›ZPL-Befehlsliste und -Referenz

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
^XZ

ZPL-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.

  • ^XA Formatbeginn
  • ^XZ Formatende
  • ^FS Feldtrenner
  • ^FO Feldursprung
  • ^FT Feld-Grundlinie
  • ^LH Etiketten-Nullpunkt
  • ^LS Etikett verschieben
  • ^LT Etikett nach oben
  • ^FX Kommentar

Text und Schriften

Felddaten, Schrift und Größe, Standardschrift, Zeichensatz (^CI28 für UTF-8), umbrechende Textblöcke, Hex-Escapes, Drehung und Inversdruck.

  • ^FD Felddaten
  • ^A Schriftauswahl
  • ^CF Standardschrift
  • ^CI Zeichensatz
  • ^FB Textblock
  • ^TB Textblock (Breite und Höhe)
  • ^FH Hexadezimal-Kennzeichen
  • ^FW Feldausrichtung
  • ^FR Invertierter Druck
  • ^FV Variables Feld
  • ^PA Erweiterte Texteigenschaften
  • ^CW Schriftkennung

Barcodes

^BY setzt Modulbreite und Standardhöhe für den folgenden Barcode; danach ein Befehl pro Symbologie, 1D und 2D.

Grafik und Bilder

Rahmen und Linien (^GB), Kreise, Ellipsen, Diagonalen, eingebettete Bitmaps (^GF) und im Druckerspeicher abgelegte Grafiken.

  • ^GB Grafikbox
  • ^GC Grafikkreis
  • ^GD Diagonale Linie
  • ^GE Grafikellipse
  • ^GF Grafikfeld
  • ^IM Bild platzieren
  • ^DG Grafik laden
  • ^XG Grafik aufrufen

Medien und Druckereinrichtung

Etikettenbreite und -länge, Druckausrichtung, Inversdruck des ganzen Etiketts, Maßeinheiten und Anzahl der Kopien.

  • ^PW Druckbreite
  • ^LL Etikettenlänge
  • ^PO Druckausrichtung
  • ^PM Spiegelbild des Etiketts drucken
  • ^LR Etikett invertieren
  • ^MU Maßeinheit festlegen
  • ^PQ Druckmenge

Druckbares ZPL-Cheat-Sheet →

Eine druckbare Ein-Seiten-Zusammenfassung ist das ZPL-Cheat-Sheet; zum sofortigen Ausprobieren der Online-ZPL-Viewer. ZPL-Cheat-Sheet · Online-ZPL-Viewer

ZPL-Lint-Regeln →

Formatsteuerung

^XA
Formatbeginn

Kennzeichnet den Anfang eines Etikettenformats. Jedes Etikett beginnt mit ^XA.

^XZ
Formatende

Beendet das Etikettenformat und druckt bzw. rendert das Etikett.

^FS
Feldtrenner

Beendet ein Feld. Jedes ^FD-, ^GB- oder Barcode-Feld wird mit ^FS abgeschlossen.

^FX
Kommentar

Ein Kommentar. Er hat keine Wirkung auf das Rendern und wird übersprungen.

^CF
Standardschrift

Legt Schrift, Höhe und Breite für die folgenden ^FD-Felder fest.

^CI
Zeichensatz

Wählt die internationale Zeichenkodierung. Die Engine setzt UTF-8 voraus (^CI28).

^PW
Druckbreite

Legt die Druckbreite des Etiketts in Punkten fest.

^LL
Etikettenlänge

Legt die Etikettenlänge in Punkten fest.

^LH
Etiketten-Nullpunkt

Verschiebt den Referenzpunkt der linken oberen Ecke (Home) des Etiketts.

^LT ·
Etikett nach oben

Verschiebt das gesamte Etikett senkrecht.

^PO
Druckausrichtung

Wählt die Druckausrichtung: ^POI druckt das gesamte Etikett um 180° gedreht. Die Vorschau zeichnet es ebenfalls gedreht.

^LR
Etikett invertieren

Druckt folgende Felder invertiert (negativ); ^LRN schaltet es aus.

^LS
Etikett verschieben

Verschiebt ALLE Felder horizontal. Versandetiketten tragen meist ^LS0 (ohne Wirkung); ein Wert ungleich null verschiebt jedes Feld.

^PM
Spiegelbild des Etiketts drucken

Spiegelt den gesamten druckbaren Bereich von links nach rechts; bleibt bis ^PMN aktiv. Die Vorschau zeichnet das Spiegelbild ebenfalls.

^CC
Formatpräfix ändern

Ändert das Präfix der Formatbefehle (^) in ein anderes Zeichen (auch ~CC); Vorschau und Prüfung wenden das neue Präfix an.

^CT
Steuerprä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

Grafik

Barcodes

^BY
Barcode-Standardwerte

Legt Modulbreite, Verhältnis und Höhe für die folgenden Barcodes fest.

^BC
Code 128

Ein Code-128-Barcode — der häufigste lineare Barcode in Versand und Logistik.

^BE
EAN-13

Ein EAN-13-Handelsbarcode (die letzte Ziffer wird automatisch berechnet).

^BQ
QR-Code

Ein QR-Code. Die Daten werden üblicherweise mit dem Präfix ^FDQA,... angegeben.

^BX
Data Matrix

Ein Data-Matrix-2D-Barcode — viele Daten auf sehr kleiner Fläche.

^B3
Code 39

Code 39 — ein linearer Barcode für Großbuchstaben und Ziffern.

^B7
PDF417

Ein gestapelter PDF417-Barcode — hohe Datenmenge auf mehreren Zeilen.

^B1
Code 11

Code 11 (USD-8) — Telekom- und Laboretiketten.

^B2
Interleaved 2/5

Interleaved 2 of 5 — numerische Daten in Ziffernpaaren.

^B8
EAN-8

EAN-8 — kurzer Handelscode für kleine Verpackungen.

^B9
UPC-E

UPC-E — komprimierter UPC für kleine Verpackungen.

^BA
Code 93

Code 93 — der dichtere Nachfolger von Code 39.

^BI
Industrial 2/5

Industrial 2 of 5 — nur numerisch, industriell.

^BJ
Standard 2/5

Standard 2 of 5 — nur numerisch.

^BK
Codabar

Codabar — Blutbanken, Bibliotheken, Kurieretiketten.

^BM
MSI

MSI Plessey — Regal- und Inventaretiketten.

^BU
UPC-A

UPC-A — der nordamerikanische Handelsstandard.

^BR
GS1 DataBar

GS1 DataBar (RSS Expanded) — kleiner Handel und Frischware.

^B0
Aztec

Aztec Code — 2D, benötigt keine Ruhezone.

^BO
Aztec

Aztec Code (Schreibweise ^BO) — erzeugt dieselbe Symbologie wie ^B0.

^BF
MicroPDF417

MicroPDF417 — PDF417 komprimiert für schmalen Raum.

^BD
MaxiCode

MaxiCode — die Symbologie auf UPS-Versandetiketten.

Fortgeschritten

Labelixa-Erweiterung (Vorschau)

RFID

Druckereinstellungen