Polecenia ZPL — ściągawka dla drukarek Zebra

Zaktualizowano 11 czerwca 2026

To jest praktyczna dokumentacja poleceń ZPL II pokrywających zdecydowaną większość rzeczywistych etykiet: struktura formatu, tekst, czcionki, kody kreskowe, grafika i sterowanie drukarką. Wszystkie pozycje i rozmiary podane są 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

PolecenieSkładniaCo robi
^XA^XAPoczątek formatu etykiety. Każda etykieta zaczyna się tym poleceniem.
^XZ^XZKoniec formatu etykiety. Drukarka renderuje i drukuje etykietę po otrzymaniu tego polecenia.
^FX^FXcommentKomentarz — ignorowany przez drukarkę. Zakończ go ^FS jak każde pole.
^PW^PWwidthSzerokość etykiety w kropkach. Ustaw na szerokość etykiety, aby pola nie były przycinane.
^LL^LLlengthDługość etykiety w kropkach. Wymagana głównie dla mediów ciągłych (bez szczeliny).
^LH^LHx,yPunkt bazowy etykiety — przesuwa punkt origin dla wszystkich kolejnych pozycji ^FO.
^PQ^PQqtyLiczba kopii — ile kopii tej etykiety wydrukować.
^PR^PRspeedPrędkość druku w calach na sekundę. Wolniej często drukuje ciemniej i wyraźniej.
^MD^MDdarknessRegulacja ciemności druku, od -30 do 30. Zwiększ, jeśli wydruk jest słaby.

Pola i tekst

PolecenieSkładniaCo robi
^FO^FOx,yField origin — umieszcza następne pole na pozycji x,y kropek od punktu bazowego etykiety.
^FD^FDdataField data — zawartość (tekst lub dane kodu kreskowego) bieżącego pola.
^FS^FSField separator — zamyka bieżące pole. Wymagane po każdym polu.
^FB^FBwidth,lines,space,alignField block — zawija tekst ^FD w blok: maks. szerokość, maks. wiersze, odstęp między wierszami, wyrównanie (L/C/R/J).
^FR^FRField reverse — drukuje pole biało na czarnym tle tam, gdzie nakłada się na czarny obszar.
^FH^FHField hexadecimal — pozwala na sekwencje _xx hex w ^FD, np. _C3_A9 dla é.
^CI^CIencodingZestaw znaków; ^CI28 wybiera UTF-8 i jest zalecany dla tekstu z nie-ASCII.

Czcionki

PolecenieSkładniaCo robi
^A^Afo,h,wCzcionka 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,wZmień domyślną czcionkę dla wszystkich kolejnych pól, które nie ustawiają własnego ^A.
^A@^A@o,h,w,nameUż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

PolecenieSkładniaCo robi
^BY^BYw,r,hDomyś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,mCode 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,gCode 39 — starszy symbol 1D wciąż wymagany w niektórych specyfikacjach przemysłowych i obronnych.
^BE^BEo,h,f,gKod kreskowy EAN-13 (użyj ^BU dla UPC-A).
^BQ^BQa,model,mag,ecKod 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,fData Matrix — kompaktowy kod 2D powszechny w etykietach elektronicznych i medycznych.
^B7^B7o,h,m,c,r,tPDF417 — skumulowany kod 2D używany na dokumentach tożsamości i w niektórych dokumentach logistycznych.

Aby uzyskać kod kreskowy dający się zeskanować, zadbaj o trzy rzeczy: szerokość modułu (^BY pierwszy parametr) co najmniej 2–3 kropki przy 203 dpi, strefę ciszy ~10 szerokości modułu pustej przestrzeni po obu stronach, oraz odpowiednią wysokość (kod 1D poniżej ~50 kropek jest trudny do odczytania przez ręczne skanery).

Grafika

PolecenieSkładniaCo robi
^GB^GBw,h,t,c,rRamka 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,cKoło graficzne o średnicy d i grubości obramowania t.
^GD^GDw,h,t,c,oUkośna linia graficzna wewnątrz prostokąta w×h; o ustawia kierunek (L lub R).
^GF^GFa,b,c,d,dataPole graficzne — osadza bitmapę (np. logo) bezpośrednio w etykiecie jako dane hex lub binarne.
~DG~DGd:name,t,w,dataPobierz grafikę — zapisz obraz w drukarce, a następnie umieść go za pomocą ^XG.
^XG^XGd:name,mx,myPrzywołaj zapisaną grafikę w bieżącym polu origin, z powiększeniem x/y.

Sterowanie drukarką i status

PolecenieSkładniaCo robi
~HS~HSStatus hosta — drukarka odpowiada informacjami o braku papieru, pauzie, buforze i liczniku odometrycznym.
~HI~HIIdentyfikacja hosta — model, wersja firmware, DPI i pamięć.
^MM^MMmodeTryb 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~JCUruchom kalibrację mediów (drukarka podaje kilka etykiet, aby znaleźć szczelinę).
~JA~JAAnuluj wszystkie formaty etykiet w buforze drukarki.
^JUS^JUSZapisz 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
^XZ

Rę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 drukować z przeglądarki przez USB.

Aby uzyskać wyczerpujące informacje o parametrach wykraczające poza tę ściągawkę, autorytatywnym źródłem jest oficjalny ZPL II Programming Guide firmy Zebra, dostępny bezpłatnie na stronie pomocy technicznej Zebra.