Anmelden
Produkte
ZPL-ViewerBarcode-GeneratorBild → ZPLZPL-SpickzettelEtiketten-DesignerVorlagen-Galerie
Entwickler
API-SchnellstartAPI-ReferenzMCP-ServerMassenerzeugungWebhooksSDKs & BeispieleLimitsDirectPrint-Agent NeuGitHub ActionVS-Code-ErweiterungOn-Premise
Lösungen
Logistik und VersandE-CommerceERP & WMSProduktionEinzelhandelGesundheitswesen und LaborAlle Lösungen
Tools
ZPL-DiagnosezentrumZPL-DebuggerGrößen- und DPI-AnalyseDPI-KonverterBarcode-PlatzrechnerVersandetiketten-AnalyseSchriftprüfungAusrichtungs-DebuggerKalibrierungsassistentDruckerkompatibilitätsprüfungBarcode-LesbarkeitsprüfungDruckersprachen-ErkennungThermodrucker-TestpaketZPL-ToolsEPL-ToolsTSPL-ToolsCPCL-ToolsDruckersprachen-KonverterAlle WerkzeugeRatgeberPreise
Sprache
EnglishTürkçeDeutsch
Startseite›Ratgeber›ZPL-Text läuft über den Etikettenrand (mit ^FB umbrechen)

ZPL-Text läuft über den Etikettenrand (mit ^FB umbrechen)

Veröffentlicht: · Aktualisiert:

Eine Adresse oder ein Produktname ist länger als geplant, und das Ende fehlt auf dem gedruckten Etikett — am rechten Rand abgeschnitten. Der Drucker ist nicht defekt: Ein einfaches ^FD-Feld ist eine einzige Textzeile, und ZPL bricht sie nicht von selbst um.

Die Ursache: ein Textfeld ist eine Zeile

Ein Feld aus ^FO, einer Schrift und ^FD beginnt an seinem Ursprung und läuft nach rechts, solange die Daten reichen. Was über die Druckbreite hinausgeht, wird nicht gedruckt. Dieses Feld hat 58 Zeichen bei einer 40-Punkt-Schrift, weit breiter als ein 4-Zoll-Etikett:

^XA
^FO30,40^A0N,40,40
^FDShip to: Warehouse 7, Industriestrasse 114, 70565 Stuttgart^FS
^XZ

Dieses Etikett im ZPL-Viewer öffnen →

Die Lösung: das Feld in einen ^FB-Block setzen

^FB (Field Block) formatiert das Feld mit Ursprung, Schrift und Drehung des Feldes zu einem Textblock mit automatischem Wortumbruch (Zebra-Handbuch, Seite 186). Die fünf Parameter:

^XA
^FO30,40^A0N,40,40
^FB740,3,4,L,30
^FDShip to: Warehouse 7\&Industriestrasse 114, 70565 Stuttgart^FS
^XZ

Dieses Etikett im ZPL-Viewer öffnen →

Zwei Details im Beispiel sind wichtig. \& in den Daten ist ein erzwungener Zeilenumbruch (Seite 187) — normale CR/LF-Zeichen in den Daten werden verworfen, ein Enter in Ihrer Vorlage bewirkt also nichts. Und der hängende Einzug von 30 Punkten rückt jede Zeile nach der ersten ein.

Die Überraschung: zusätzliche Zeilen überschreiben die letzte

Braucht der Text mehr Zeilen als b erlaubt, schneidet ZPL ihn nicht sauber ab. Das Handbuch sagt es ausdrücklich: Text, der die maximale Zeilenzahl überschreitet, überschreibt die letzte Zeile (Seite 186). Das Ergebnis ist ein unlesbarer Brei in der letzten Zeile. Erhöhen Sie b, kürzen Sie die Daten oder verkleinern Sie die Schrift; die Schriftgröße ändert auch die Blockgröße, weil die Zeilenhöhe der Schrift folgt.

Weitere Regeln aus dem Handbuch

Bevor Sie zu ^FB greifen: drei Lösungen, die eine Zeile behalten

Umbrechen ist für eine Adresse richtig. Für einen Produktnamen, der auf einer Zeile bleiben muss, entscheiden drei andere Dinge, ob er passt — und jedes ist eine Zahl, die Sie prüfen statt raten können.

  1. Die Schrift schmaler machen, nicht den Text. Der Breitenparameter von ^A0 ist von der Höhe unabhängig. In unserem Renderer misst die 58-Zeichen-Zeile oben 980 Punkte bei ^A0N,40,40 und 735 Punkte bei ^A0N,40,30 — die zweite passt bei gleicher 40-Punkt-Höhe auf ein 4-Zoll-Etikett (812 Punkte bei 203 dpi). Eine 25 % schmalere Glyphe bleibt auf einem Versandetikett lesbar; eine kleinere Schrift oft nicht.
  2. Prüfen, welche Breite der Drucker annimmt. Text wird an der mit ^PW gesetzten Druckbreite abgeschnitten, nicht am physischen Rand. Ein 4-Zoll-Etikett mit ^PW600 oder mit einem auf schmaleres Material stehenden Druckerstandard verliert in jedem Feld die rechten 200 Punkte. Der Größenanalysator liest ^PW/^LL aus einem Format und nennt die physische Größe je Auflösung.
  3. Das Feld versetzen oder drehen. Ein zweites ^FO mit eigenem ^FD teilt die Daten in der Vorlage — so machen es ERP-Vorlagen, die sich nicht auf ^FB verlassen können — und ^FW dreht ein langes Feld entlang der langen Etikettenkante, wo ein 6-Zoll-Etikett 1218 statt 812 Punkte bietet.

Zwei benachbarte Symptome haben eigene Seiten. Fehlen rechts auch Rahmen und Barcodes, nicht nur Text, wird das Etikett selbst abgeschnitten — siehe ZPL-Etikett abgeschnitten. Ist der Text vollständig, sitzt aber nicht mittig, siehe Text in ZPL zentrieren. Die vollständige Parametertabelle des Blockbefehls steht auf der ^FB-Befehlsseite.

Vor dem Druck prüfen

Fügen Sie das Format in die ZPL-Vorschau ein. Die Vorschau folgt den Regeln oben: \& bricht die Zeile um, eine fehlende oder zu schmale Breite druckt nichts, und Zeilen über b hinaus werden auf die letzte Zeile gezeichnet — derselbe Brei wie beim Drucker. Die Render-API liefert zusätzlich im Header X-Warnings eine Warnung, wie viele Zeilen der Text gebraucht hätte. Diese Fälle haben wir nicht an einem physischen Drucker geprüft; das Verhalten ist das, was Zebras Programmierhandbuch dokumentiert.

Ist das Symptom ein anderes, ordnet die ZPL-Fehlersuche das, was der Drucker getan hat, seiner üblichen Ursache zu.

Quellen

Häufig gestellte Fragen

Warum wird mein ZPL-Text am Etikettenrand abgeschnitten?

Ein einfaches ^FD-Feld ist eine Zeile, und ZPL bricht es nie um. Was über die Druckbreite hinausgeht, wird nicht gedruckt. Setzen Sie das Feld zum Umbrechen in einen ^FB-Block.

Wie erzwinge ich einen Zeilenumbruch in ZPL-Text?

In einem ^FB-Block ist \& in den Daten ein Wagenrücklauf/Zeilenvorschub (Zebra-Handbuch, Seite 187). Normale CR/LF-Zeichen in den Daten werden verworfen.

Warum wird mein ^FB-Text gar nicht gedruckt?

Die ^FB-Breite ist standardmäßig 0; fehlt sie oder ist sie kleiner als die Schriftbreite, wird der Text nicht gedruckt (Seite 186). Geben Sie dem Block eine Breite in Punkten.

Was passiert, wenn der Text mehr Zeilen braucht als ^FB erlaubt?

Er wird nicht abgeschnitten: Text über der maximalen Zeilenzahl überschreibt die letzte Zeile (Seite 186) und wird als unlesbarer Brei gedruckt. Erhöhen Sie die Zeilenzahl oder kürzen Sie die Daten.

Kann ich den Text auf einer Zeile halten, statt ihn umzubrechen?

Ja: die Schrift schmaler machen, nicht kleiner. ^A0 nimmt Höhe und Breite getrennt; in unserem Renderer braucht eine 58-Zeichen-Zeile 980 Punkte bei ^A0N,40,40, aber 735 Punkte bei ^A0N,40,30 und passt so auf ein 4-Zoll-Etikett (812 Punkte bei 203 dpi). Prüfen Sie außerdem, ob ^PW der echten Etikettenbreite entspricht.

Verwandte Ratgeber

ZPL-Etiketteninhalt verschoben

Ein nach rechts oder unten verschobenes Layout hat vier Verdächtige in der Datei — ^LH, ^LS, ^LT und den ^FO/^FT-Unterschied — bevor ein Sensor schuld ist.

ZPL-Etikett wird am Rand abgeschnitten

Ein beschnittenes ZPL-Etikett hat zwei Ursachen: Felder jenseits von ^PW/^LL oder eine 300-DPI-Datei auf einem 203-DPI-Drucker. So unterscheiden Sie sie.

ZPL-Etikett druckt auf dem Kopf

Ein gedrehtes ZPL-Etikett hat drei Schalter: ^PO dreht das ganze Etikett, ^FW setzt den Standard, ^A dreht ein einzelnes Feld. Finden Sie den gesetzten.

Zebra-Etikett druckt zu klein

Druckt ein 4x6-Etikett links oben auf zwei Dritteln der Größe, ist es ein 203/300-DPI-Konflikt. Prüfen, warum ^MU kaum hilft, Datei skalieren.

Eigenen ZPL-Code testen →