Arbeitsbereich
Werkzeuge/Prüfen/Ausrichtungs-Debugger

ZPL-Ausrichtungs-Debugger

ZPL einfügen und sehen: Drehung und Rahmen jedes Felds über der Vorschau, wie ^FW und ^PO das gedruckte Layout verändern und was jeder ^FW-Standard bewirken würde — ein Klick pro Option. Die Positionen stammen aus der Render-Engine selbst, nicht aus einem zweiten Parser.

Einen ^FW-Standard ausprobieren:

Ausrichtungsbericht

#TypDrehungUrsprung (x, y)Gedruckt (x, y)Größe (Punkte)BeschnittenDaten

Hinweise

    ZPL mit dem gewählten ^FW (so wurde gezeichnet)

    So nutzen Sie den Ausrichtungs-Debugger

    1. Fügen Sie das ZPL genau so ein, wie Ihr System es sendet. Wenn das Etikett irgendwo ^FW oder ^PO verwendet, lassen Sie diese Zeilen drin — genau dafür ist das Werkzeug da.
    2. Wählen Sie die Druckerauflösung, wenn Sie sie kennen; sonst leitet das Werkzeug sie nur ab, wenn die Etikettengröße genau einer Standardgröße entspricht, und sagt es, wenn es 203 DPI annehmen musste. Punktkoordinaten hängen nicht von der DPI ab, die physische Größe schon.
    3. Klicken Sie auf Analysieren. Die Vorschau zeigt jedes Text- und Barcodefeld als Rahmen mit Nummer und Drehbuchstabe; Rahmen, die über den Etikettenrand ragen, sind gestrichelt. Die Tabelle listet Ursprung, gedruckte Position, Größe und ob das Feld eine eigene Drehung trägt oder den Dokumentstandard übernimmt.
    4. Probieren Sie mit den ^FW-Schaltflächen N, R, I und B als Dokumentstandard. Das Werkzeug schreibt ^FW in Ihrem ZPL um, zeichnet das Ergebnis und zeigt den umgeschriebenen Code zum Zurückkopieren. Felder mit expliziter Drehung in ^A oder ^B behalten sie — so verhält sich auch der Drucker.

    Für wen ist das

    Für Entwickler und Support-Ingenieure, die Tickets wie "das Etikett druckt seitwärts", "auf dem Kopf" oder "der Barcode ist am falschen Ende" verfolgen. ZPL hat drei Schalter, die alle wie Drehung aussehen und sich unterschiedlich verhalten: ^FW setzt die Standarddrehung für Felder ohne eigene Angabe, der Drehbuchstabe in ^A- und ^B-Befehlen überschreibt sie pro Feld, und ^PO dreht das fertige Etikett im Drucker um 180°. Den Code zu lesen verrät selten, welcher davon ein Feld verschoben hat; den Rahmen jedes Felds, seine effektive Drehung und seine Lage nach ^PO zu sehen, schon. Das Werkzeug nutzt dieselbe Render-Engine wie der ZPL-Viewer; die Rahmen stammen aus der Zeichnung selbst und nicht aus einem zweiten Parser, der ihr widersprechen könnte. Es endet bewusst am Etikett: Ob das physische Etikett mit dem Kopf oder dem Fuß voran aus dem Drucker kommt, hängt auch von Medienführung, Abrisskante und Spender ab — das kann keine ZPL-Analyse wissen.

    Häufige Fragen

    • Warum ändert ^FW manche meiner Felder nicht? — ^FW setzt nur den Standard. Ein Feld, dessen ^A- oder ^B-Befehl einen Drehbuchstaben (N, R, I, B) nennt, behält ihn unabhängig von ^FW; die Spalte "eigene Drehung" zeigt, welche Felder das sind. Um sie zu drehen, ändern Sie den Buchstaben im Feldbefehl.
    • Wendet die Vorschau ^PO wirklich an? — Die Render-Engine überspringt ^PO und meldet es als nicht unterstützt. Dieses Werkzeug wendet ^POI an, indem es das fertige Bild um 180° dreht — Zebras Definition des Befehls: Er invertiert das gesamte Etikettenformat. Koordinaten in der Tabelle gelten vor der Drehung, die gedruckte Position wird daneben berechnet; beides wird nie vermischt.
    • Warum ändert die ^FW-Schaltfläche das ZPL und nicht nur das Bild? — Weil ein Bild allein verbergen würde, was sich geändert hat. Das Werkzeug fügt das gewählte ^FW nach jedem ^XA ein, entfernt vorhandene ^FW-Befehle, zeichnet das Ergebnis und zeigt den umgeschriebenen Code. Was Sie gezeichnet sehen, ist genau der Code, den Sie in Ihr System zurückkopieren können.
    • Welches Etikett wird bei einem Job mit mehreren Etiketten analysiert? — Nur der erste ^XA…^XZ-Block. Der Bericht nennt, wie viele Etiketten der Job enthält; für eine Aufschlüsselung von Kopien, Größen und Beschnitt pro Etikett nutzen Sie das Diagnosezentrum, das genau dafür einen Job-Abschnitt hat.
    • Das Etikett sieht hier richtig aus, druckt aber trotzdem gedreht — warum? — Dann liegt die Ursache außerhalb des ZPL: andersherum eingelegte Medien, ein mit ^PO oder ^FW in einer gespeicherten Konfiguration gesetzter Druckerstandard oder ein Treiber, der den Job dreht. Prüfen Sie die gespeicherten Druckereinstellungen und die Seiteneinrichtung des Treibers, bevor Sie den Etikettencode ändern.

    Etiketten im Konto speichern und mit DirectPrint drucken — kostenloses Konto. Kostenloses Konto erstellen

    Dieselbe Aufgabe aus Code erledigen

    Gleiche Engine, gleiches Ergebnis: REST-API, Kommandozeile oder ein KI-Assistent über MCP. Anonyme Aufrufe funktionieren; ein API-Schlüssel erhöht das Kontingent.

    RESTcurl -X POST "https://api.labelixa.com/v1/orientation/analyze?dpi=203" --data-binary @label.zpl

    API-Referenz · MCP-Einrichtung