Co to jest ZPL? Zebra Programming Language

Zaktualizowano 17 sierpnia 2026

Polecenia ZPL przesyłane z komputera do drukarki termicznej i gotowej etykiety z kodem kreskowym

ZPL (język programowania Zebra) to język poleceń używany przez zgodne drukarki termiczne do opisywania etykiet. Zamiast gotowego obrazu strony drukarka ZPL otrzymuje polecenia w zwykłym tekście, takie jak „umieść ten tekst tutaj, narysuj ten kod kreskowy tam, wydrukuj jedną kopię”, interpretuje je i renderuje etykietę z użyciem skonfigurowanej rozdzielczości głowicy drukującej.

ZPL korzysta ze zwięzłych poleceń tekstowych, które mogą generować aplikacje, takie jak systemy ERP, skrypty i narzędzia przeglądarkowe. Obsługa przez drukarkę zależy od modelu i konfiguracji: Zebra dokumentuje obsługę ZPL II w specyfikacjach poszczególnych modeli, a niektóre drukarki innych producentów oferują udokumentowany tryb emulacji zgodny z ZPL.

Jak wygląda etykieta ZPL

Dokument ZPL to ciąg poleceń, z których każde zaczyna się daszkiem (^). Każda etykieta jest otoczona między ^XA (start formatu) a ^XZ (koniec formatu). Oto kompletna, działająca etykieta:

^XA
^CF0,40
^FO50,50^FDHELLO WORLD^FS
^FO50,110^GB700,4,4^FS
^BY3,2,100
^FO150,150^BCN,100,Y,N,N^FD12345678^FS
^XZ

Czytając wiersz po wierszu:

  • ^XA … ^XZ — otwiera i zamyka format etykiety. Wszystko pomiędzy opisuje jedną etykietę.
  • ^CF0,40 — ustawia domyślną czcionkę na skalowaną czcionkę 0 o wysokości 40 kropek.
  • ^FO50,50 — Field Origin: pozycjonuje następne pole 50 kropek od lewej i 50 kropek od góry.
  • ^FDHELLO WORLD^FS — Field Data a następnie Field Separator: rzeczywista treść pola.
  • ^GB700,4,4 — rysuje Graphic Box o szerokości 700 kropek i wysokości 4 kropek — tutaj użyte jako pozioma linia podziału.
  • ^BY3,2,100 a następnie ^BCN,100,Y,N,N — ustawia domyślne parametry kodu kreskowego (szerokość modułu, stosunek, wysokość), a potem renderuje kod kreskowy Code 128 z danymi 12345678 i czytelną dla człowieka linią poniżej.

Kropki, nie piksele: zrozumienie DPI

Każda współrzędna i rozmiar w ZPL są mierzone w kropkach drukarki, a fizyczny rozmiar kropki zależy od rozdzielczości głowicy drukującej. Typowe rozdzielczości to 203 dpi (8 kropek/mm), 300 dpi (12 kropek/mm) i 600 dpi (24 kropki/mm). Na drukarce 203 dpi etykieta wysyłkowa 4 × 6 cali to 812 × 1218 kropek; na drukarce 300 dpi ta sama etykieta to 1200 × 1800 kropek. ZPL przygotowany dla jednej rozdzielczości drukuje się mniejszy lub większy na innej, dlatego różnica DPI jest częstą przyczyną problemu „moja etykieta wygląda źle na nowej drukarce”. Rozmiary trzeba skalować do docelowego DPI.

ZPL vs. EPL vs. druk przez sterownik

Możesz też natknąć się na EPL (Eltron Programming Language), używany przez niektóre starsze lub jawnie zgodne drukarki. Obsługa ZPL i EPL zależy od modelu i oprogramowania sprzętowego, dlatego przed wyborem języka sprawdź dokumentację producenta drukarki. Alternatywą dla surowego wyjścia w języku drukarki jest druk przez sterownik, w którym sterownik Windows lub CUPS przygotowuje wyrenderowaną stronę dla skonfigurowanej drukarki. Surowy ZPL może zapewniać bezpośrednią kontrolę współrzędnych i zwarte ładunki tekstowe, natomiast drukowanie przez sterownik może być lepsze, gdy urządzenie lub system operacyjny nie udostępnia zgodnej ścieżki surowego ZPL.

Jak pisać — lub generować — ZPL

Dla jednorazowej etykiety pisanie ZPL ręcznie z otwartą dokumentacją poleceń jest jak najbardziej wykonalne: język jest mały, a kilka poleceń (^FO, ^FD, ^A, ^BC, ^GB) pokrywa większość rzeczywistych etykiet. Problem zaczyna się, gdy musisz iterować nad układem — każde przesunięcie oznacza edycję współrzędnych w kropkach, ponowne wysłanie pliku i marnowanie papieru etykietowego.

To właśnie ten problem rozwiązują projektanty wizualne. ZPLCraft udostępnia kanwę w rzeczywistym rozmiarze, na której rozmieszczasz tekst, kody kreskowe, linie i ramki, a następnie generuje ZPL przeskalowany dla wybranego DPI drukarki. Dane kodu kreskowego, wymiary i strefy ciszy nadal muszą spełniać wymagania wybranej symboliki, a wydruk należy zweryfikować na docelowej drukarce i skanerze. Kod możesz wyeksportować do systemu, który już wysyła ZPL, lub użyć drukowania WebUSB z przeglądarki , gdy przeglądarka, system operacyjny i drukarka udostępniają zgodny interfejs możliwy do przejęcia.

Najczęściej zadawane pytania podstawowe

Czy ZPL jest darmowy?

Zebra publikuje przewodnik programowania ZPL II do publicznego wglądu, a polecenia ZPL można pisać w edytorze tekstu. Oprogramowanie drukarki, czcionki, oprogramowanie sprzętowe i znaki towarowe mogą podlegać odrębnym warunkom licencyjnym.

Jakiego rozszerzenia pliku używa ZPL?

Nie ma wymaganego rozszerzenia — ZPL to zwykły tekst. Spotkasz .zpl, .txt i .prn w praktyce; drukarki nie zwracają na to uwagi, po prostu przetwarzają strumień bajtów.

Czy mogę podejrzeć ZPL bez drukarki?

Tak — usługi renderujące, takie jak Labelary, konwertują ZPL na obraz, a edytor ZPLCraft pokazuje podgląd etykiety na żywo podczas projektowania, więc papier etykietowy zużywasz dopiero gdy układ jest gotowy.

Które drukarki są kompatybilne z ZPL?

Zgodność zależy od modelu i konfiguracji. Sprawdź w specyfikacji producenta obsługę ZPL lub ZPL II albo udokumentowany tryb emulacji, potwierdź docelowe DPI i wymagane funkcje oraz przetestuj dokładną ścieżkę wyjściową. Samo połączenie przez USB lub port TCP 9100 nie dowodzi, że drukarka akceptuje ZPL. Zgodność i zalecenie

Źródła