ZPL Komut Referansı — Zebra Yazıcılar için Özet Sayfa

11 Haziran 2026 tarihinde güncellendi

Bu, gerçek etiketlerin büyük çoğunluğunu kapsayan ZPL II komutları için çalışan bir referanstır: format yapısı, metin, fontlar, barkodlar, grafikler ve yazıcı kontrolü. Tüm konumlar ve boyutlar yazıcı noktası cinsindendir (203 dpi = 8 nokta/mm — temel bilgiler için bkz. ZPL nedir?). Söz dizimi sütununda gösterilen parametreler: x,y = sol üst köşeden konum, h,w = yükseklik ve genişlik, o = yönelim (N normal, R 90°, I 180°, B 270°).

Etiket formatı

KomutSöz DizimiNe yapar
^XA^XAEtiket formatının başlangıcı. Her etiket bu komutla başlar.
^XZ^XZEtiket formatının sonu. Yazıcı bunu aldığında etiketi oluşturur ve yazdırır.
^FX^FXcommentYorum — yazıcı tarafından yoksayılır. Herhangi bir alan gibi ^FS ile sonlandırın.
^PW^PWwidthNokta cinsinden baskı genişliği. Alanların kesilmemesi için etiket genişliğinize ayarlayın.
^LL^LLlengthNokta cinsinden etiket uzunluğu. Esas olarak sürekli (boşluksuz) ortam için gereklidir.
^LH^LHx,yEtiket ana konumu — sonraki tüm ^FO konumlarının kaynağını kaydırır.
^PQ^PQqtyBaskı miktarı — bu etiketin kaç kopyasının yazdırılacağı.
^PR^PRspeedİnç/saniye cinsinden baskı hızı. Daha yavaş genellikle daha koyu ve keskin yazdırır.
^MD^MDdarknessOrtam koyuluğu ayarı, -30 ile 30 arası. Baskı soluksa artırın.

Alanlar ve metin

KomutSöz DizimiNe yapar
^FO^FOx,yAlan kökeni — bir sonraki alanı etiket ana konumundan x,y nokta mesafeye konumlandırır.
^FD^FDdataAlan verisi — geçerli alanın içeriği (metin veya barkod verisi).
^FS^FSAlan ayırıcı — geçerli alanı kapatır. Her alandan sonra gereklidir.
^FB^FBwidth,lines,space,alignAlan bloğu — ^FD metnini bir bloğa sarar: maks. genişlik, maks. satır, satır aralığı, hizalama (L/C/R/J).
^FR^FRAlan ters — alan siyah bir alanın üstüne bindiğinde siyah üzerine beyaz yazdırır.
^FH^FHAlan onaltılık — ^FD'de _xx onaltılık çıkışlara izin verir, örn. é için _C3_A9.
^CI^CIencodingKarakter seti; ^CI28 UTF-8'i seçer ve ASCII dışı herhangi bir metin için önerilir.

Fontlar

KomutSöz DizimiNe yapar
^A^Afo,h,wBir sonraki alan için font: f font harfi (0–9, A–Z), yönelim, nokta cinsinden yükseklik ve genişlik. ^A0N,40,40 ölçeklenebilir varsayılan fontu 40 noktada kullanır.
^CF^CFf,h,wKendi ^A'sını ayarlamayan sonraki tüm alanlar için varsayılan fontu değiştirir.
^A@^A@o,h,w,nameYazıcıda depolanan bir font dosyasını kullanır (örn. indirilmiş TrueType).

Font 0 ölçeklenebilir vektör fontu ve genellikle tercih edilen seçimdir; fontlar A–H yalnızca kendi boyutlarında veya tam katlarında doğru görünen sabit boyutlu bitmap fontlardır.

Barkodlar

KomutSöz DizimiNe yapar
^BY^BYw,r,hBarkod alan varsayılanları: nokta cinsinden modül (dar çubuk) genişliği, geniş-dar oranı, varsayılan yükseklik. Barkod komutundan önce ayarlayın.
^BC^BCo,h,f,g,e,mCode 128 — kargo ve lojistik için ağır iş 1D barkod. f=Y okunabilir satırı, g=Y onu kodun üzerinde yazdırır.
^B3^B3o,e,h,f,gCode 39 — bazı endüstriyel ve savunma özelliklerinde hâlâ gereken eski 1D semboloji.
^BE^BEo,h,f,gEAN-13 perakende barkodu (UPC-A için ^BU kullanın).
^BQ^BQa,model,mag,ecQR kod. 1–10 büyütme modül boyutunu ayarlar; ec hata düzeltmeyi ayarlar (H/Q/M/L). Veriyi kodlama moduyla ön ekleyin, örn. ^FDQA,https://…
^BX^BXo,h,s,c,r,fData Matrix — elektronik ve sağlık etiketlerinde yaygın kompakt 2D kod.
^B7^B7o,h,m,c,r,tPDF417 — kimlik kartlarında ve bazı lojistik belgelerinde kullanılan yığılmış 2D kod.

Taranabilir bir barkod için üç şeyi doğru yapın: en az 2–3 noktalık 203 dpi modül genişliği (^BY ilk parametre), her iki yanda ~10 modül genişliği boş alan sessiz bölgesi ve yeterli yükseklik (50 noktanın altındaki 1D barkodlar elle tutulan tarayıcılar için okunması zordur).

Grafikler

KomutSöz DizimiNe yapar
^GB^GBw,h,t,c,rGrafik kutu: genişlik, yükseklik, kenarlık kalınlığı, renk (B/W), köşe yuvarlaklığı 0–8. İnce bir ^GB çizgi çizme yönteminizdir.
^GC^GCd,t,cd çaplı ve t kenarlık kalınlıklı grafik daire.
^GD^GDw,h,t,c,ow×h kutu içinde grafik çapraz çizgi; o yönü ayarlar (L veya R).
^GF^GFa,b,c,d,dataGrafik alanı — bir bitmap'i (örn. logo) doğrudan onaltılık veya ikili veri olarak etikete gömer.
~DG~DGd:name,t,w,dataGrafik indir — yazıcıda bir görüntü saklar, ardından ^XG ile yerleştirin.
^XG^XGd:name,mx,myDepolanan bir grafiği x/y büyütmeyle geçerli alan kökenine geri çağırır.

Yazıcı kontrolü ve durumu

KomutSöz DizimiNe yapar
~HS~HSAna durum — yazıcı kağıt sonu, duraklatma, tampon ve kilometre sayacı bilgileriyle yanıt verir.
~HI~HIAna tanımlama — model, bellenim sürümü, DPI ve bellek.
^MM^MMmodeBaskı modu: T yırtma, P soyma, R geri sarma, C kesici.
^MN^MNtypeOrtam takibi: Y boşluk/web algılama, M siyah işaret, N sürekli.
~JC~JCOrtam kalibrasyonunu çalıştırır (yazıcı boşluğu bulmak için birkaç etiket besler).
~JA~JAYazıcı tamponundaki tüm etiket formatlarını iptal eder.
^JUS^JUSGüç döngüsünde hayatta kalmaları için geçerli ayarları flash belleğe kaydeder.

Bir araya getirmek

Yukarıdaki grupların çoğunu kullanan tipik bir 4×6 kargo tipi etiket:

^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

Nokta koordinatlarını elle düzenlemek zamanla sıkıcı hale gelir — her düzen değişikliği sayıları değiştirmeyi ve yeniden yazdırmayı gerektirir. Alanları yerine sürükleyip ZPL'nin kendiliğinden yazılmasını tercih ederseniz, aşağıdaki ZPLCraft editörü görsel bir tuvali tam olarak bu tür temiz ZPL'ye derler ve tarayıcıdan USB üzerinden yazdırabilir.

Bu özet sayfanın ötesinde kapsamlı parametre detayları için yetkili kaynak Zebra'nın resmi ZPL II Programming Guide'dır; Zebra'nın destek sitesinden ücretsiz edinilebilir.