Ściągawka i dokumentacja poleceń ZPL
ZPLCraftZaktualizowano 17 sierpnia 2026
To praktyczny przewodnik po często używanych poleceniach ZPL II: strukturze formatu, tekście, czcionkach, kodach kreskowych, grafice i sterowaniu drukarką. Wszystkie pozycje i rozmiary są podane w kropkach drukarki (203 dpi = 8 kropek/mm — patrz Co to jest ZPL? po podstawy). Parametry w kolumnie składni: x,y = pozycja od lewego górnego rogu, h,w = wysokość i szerokość, o = orientacja (N normalnie, R 90°, I 180°, B 270°).
Format etykiety
| Polecenie | Składnia | Co robi |
|---|---|---|
^XA | ^XA | Początek formatu etykiety. Każda etykieta zaczyna się tym poleceniem. |
^XZ | ^XZ | Koniec formatu etykiety. Drukarka renderuje i drukuje etykietę po otrzymaniu tego polecenia. |
^FX | ^FXcomment | Komentarz — ignorowany przez drukarkę. Zakończ go ^FS jak każde pole. |
^PW | ^PWwidth | Szerokość etykiety w kropkach. Ustaw na szerokość etykiety, aby pola nie były przycinane. |
^LL | ^LLlength | Długość etykiety w kropkach. Wymagana głównie dla mediów ciągłych (bez szczeliny). |
^LH | ^LHx,y | Punkt bazowy etykiety — przesuwa punkt origin dla wszystkich kolejnych pozycji ^FO. |
^PQ | ^PQqty | Liczba kopii — ile kopii tej etykiety wydrukować. |
^PR | ^PRspeed | Prędkość druku w calach na sekundę. Wolniej często drukuje ciemniej i wyraźniej. |
^MD | ^MDdarkness | Regulacja ciemności druku, od -30 do 30. Zwiększ, jeśli wydruk jest słaby. |
Pola i tekst
| Polecenie | Składnia | Co robi |
|---|---|---|
^FO | ^FOx,y | Field origin — umieszcza następne pole na pozycji x,y kropek od punktu bazowego etykiety. |
^FD | ^FDdata | Field data — zawartość (tekst lub dane kodu kreskowego) bieżącego pola. |
^FS | ^FS | Field separator — zamyka bieżące pole. Wymagane po każdym polu. |
^FB | ^FBwidth,lines,space,align | Field block — zawija tekst ^FD w blok: maks. szerokość, maks. wiersze, odstęp między wierszami, wyrównanie (L/C/R/J). |
^FR | ^FR | Field reverse — drukuje pole biało na czarnym tle tam, gdzie nakłada się na czarny obszar. |
^FH | ^FH | Field hexadecimal — pozwala na sekwencje _xx hex w ^FD, np. _C3_A9 dla é. |
^CI | ^CIencoding | Zestaw znaków; ^CI28 wybiera UTF-8 i jest zalecany dla tekstu z nie-ASCII. |
Czcionki
| Polecenie | Składnia | Co robi |
|---|---|---|
^A | ^Afo,h,w | Czcionka dla następnego pola: litera czcionki f (0–9, A–Z), orientacja, wysokość i szerokość w kropkach. ^A0N,40,40 to skalowana czcionka domyślna o wysokości 40 kropek. |
^CF | ^CFf,h,w | Zmień domyślną czcionkę dla wszystkich kolejnych pól, które nie ustawiają własnego ^A. |
^A@ | ^A@o,h,w,name | Użyj pliku czcionki zapisanego w drukarce (np. pobranego TrueType). |
Czcionka 0 to skalowana czcionka wektorowa i typowy wybór; czcionki A–H to bitmapowe czcionki o stałym rozmiarze, które wyglądają dobrze tylko w swoich natywnych rozmiarach lub ich całkowitych wielokrotnościach.
Kody kreskowe
| Polecenie | Składnia | Co robi |
|---|---|---|
^BY | ^BYw,r,h | Domyślne parametry kodu kreskowego: szerokość modułu (wąski pasek) w kropkach, stosunek szeroki-do-wąskiego, domyślna wysokość. Ustaw przed poleceniem kodu kreskowego. |
^BC | ^BCo,h,f,g,e,m | Code 128 — podstawowy kod 1D do zastosowań wysyłkowych i logistycznych. f=Y drukuje linię czytelną dla człowieka, g=Y drukuje ją powyżej kodu. |
^B3 | ^B3o,e,h,f,g | Code 39 — starszy symbol 1D wciąż wymagany w niektórych specyfikacjach przemysłowych i obronnych. |
^BE | ^BEo,h,f,g | Kod kreskowy EAN-13 (użyj ^BU dla UPC-A). |
^BQ | ^BQa,model,mag,ec | Kod QR. Powiększenie 1–10 ustawia rozmiar modułu; ec ustawia korekcję błędów (H/Q/M/L). Poprzedź dane trybem kodowania, np. ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — kompaktowy kod 2D powszechny w etykietach elektronicznych i medycznych. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — skumulowany kod 2D używany na dokumentach tożsamości i w niektórych dokumentach logistycznych. |
Wymiary kodu kreskowego zależą od symboliki. Użyj ^BY, aby ustawić szerokość modułu, proporcję i wysokość, a następnie zastosuj wymagania właściwej symboliki, przewoźnika lub branży dotyczące wymiarów minimalnych i stref ciszy. Podgląd nie zastępuje weryfikacji fizycznego wydruku za pomocą skanera i nośnika produkcyjnego.
Grafika
| Polecenie | Składnia | Co robi |
|---|---|---|
^GB | ^GBw,h,t,c,r | Ramka graficzna: szerokość, wysokość, grubość obramowania, kolor (B/W), zaokrąglenie narożników 0–8. Cienkie ^GB to sposób rysowania linii. |
^GC | ^GCd,t,c | Koło graficzne o średnicy d i grubości obramowania t. |
^GD | ^GDw,h,t,c,o | Ukośna linia graficzna wewnątrz prostokąta w×h; o ustawia kierunek (L lub R). |
^GF | ^GFa,b,c,d,data | Pole graficzne — osadza bitmapę (np. logo) bezpośrednio w etykiecie jako dane hex lub binarne. |
~DG | ~DGd:name,t,w,data | Pobierz grafikę — zapisz obraz w drukarce, a następnie umieść go za pomocą ^XG. |
^XG | ^XGd:name,mx,my | Przywołaj zapisaną grafikę w bieżącym polu origin, z powiększeniem x/y. |
Sterowanie drukarką i status
| Polecenie | Składnia | Co robi |
|---|---|---|
~HS | ~HS | Status hosta — drukarka odpowiada informacjami o braku papieru, pauzie, buforze i liczniku odometrycznym. |
~HI | ~HI | Identyfikacja hosta — model, wersja firmware, DPI i pamięć. |
^MM | ^MMmode | Tryb druku: T odrywanie, P odklejanie, R przewijanie, C obcinanie. |
^MN | ^MNtype | Śledzenie mediów: Y wykrywanie szczeliny/siatki, M znacznik czarny, N ciągłe. |
~JC | ~JC | Uruchom kalibrację mediów (drukarka podaje kilka etykiet, aby znaleźć szczelinę). |
~JA | ~JA | Anuluj wszystkie formaty etykiet w buforze drukarki. |
^JUS | ^JUS | Zapisz bieżące ustawienia do pamięci flash, aby przetrwały odcięcie zasilania. |
Łącząc to razem
Typowa etykieta wysyłkowa 4×6 wykorzystująca większość powyższych grup:
^XA
^PW812
^CI28
^CF0,32
^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS
^FO40,230^GB732,3,3^FS
^FO40,260^FDOrder #A-10592 / 3 of 4^FS
^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZRęczna edycja współrzędnych w kropkach szybko staje się uciążliwa — każda zmiana układu oznacza zmianę liczb i ponowny wydruk. Jeśli wolisz przeciągać pola na miejsce i pozwolić, by ZPL pisał się sam, edytor ZPLCraft kompiluje wizualną kanwę do dokładnie takiego czystego ZPL i może wysłać go przez zgodną ścieżkę USB z przeglądarki do drukarki, gdy przeglądarka, system operacyjny i drukarka udostępniają interfejs możliwy do przejęcia.