ZPL komutları listesi ve referansı
Göreve göre gruplu ZPL komutları listesi: format ve konum, metin ve font, barkod, grafik, medya ayarı. Sözdizimi, parametre aralıkları ve çalışan örnekler.
Bir ZPL formatı nasıl kurulur
Her etiket ^XA ile başlar, ^XZ ile biter. Arada her alan üç parçadır: konum (^FO x,y), içerik (^FD…^FS) ve isteğe bağlı bir biçim komutu (yazı tipi ^A, barkod ^BC). Koordinatlar milimetre değil yazıcı noktasıdır — 203 DPI'da bir inç 203 nokta.
^XA
^FO50,50^A0N,40,40^FDHello^FS
^FO50,110^BY2^BCN,80,Y,N,N^FD12345678^FS
^XZGörevlere göre ZPL komutları listesi
Her iş için gereken komutlar, satır başına bir komut. Her bağ komutun kendi sayfasını açar: sözdizimi, parametre aralıkları ve örnek. Bu listenin yazdırılabilir hâli ZPL cheat sheet'tir.
Format ve konum
Etiketi açıp kapatmak, her alanı bitirmek ve yerleştirmek: ^FO sol üst köşeden, ^FT metnin taban çizgisinden; ^LH, ^LS ve ^LT tüm etiketi kaydırır.
^XAFormat Başlangıcı^XZFormat Sonu^FSAlan Sonlandırıcı^FOAlan Orijini^FTAlan Typeset^LHEtiket Başlangıcı^LSEtiket Kaydır^LTÜstten Kaydırma^FXYorum
Metin ve fontlar
Alan verisi, font ve boyut, varsayılan font, karakter seti (UTF-8 için ^CI28), kaydırmalı metin bloğu, hex kaçışları, döndürme ve ters baskı.
^FDAlan Verisi^AFont Seçimi^CFVarsayılan Font^CIKarakter Seti^FBMetin Bloğu^TBMetin Bloğu (genişlik ve yükseklik)^FHHex Göstergesi^FWAlan Yönü^FRTers Baskı^FVDeğişken Alan^PAGelişmiş Metin Özellikleri^CWYazı Tipi Tanımlayıcı
Barkodlar
^BY ardından gelen barkodun modül genişliğini ve varsayılan yüksekliğini ayarlar; sonra her semboloji için bir komut, 1D ve 2D.
^BYBarkod Varsayılanları^BCCode 128^BEEAN-13^BQQR Kod^BXData Matrix^B3Code 39^B7PDF417^B1Code 11^B2Interleaved 2/5^B8EAN-8^B9UPC-E^BACode 93^BIIndustrial 2/5^BJStandard 2/5^BKCodabar^BMMSI^BUUPC-A^BRGS1 DataBar^B0Aztec^BOAztec^BFMicroPDF417^BDMaxiCode
Grafik ve görseller
Kutu ve çizgi (^GB), daire, elips, çapraz çizgi, gömülü bitmap (^GF) ve yazıcı belleğindeki grafikler.
^GBKutu / Çizgi^GCDaire^GDÇapraz Çizgi^GEElips^GFGömülü Grafik^IMGörsel Yerleştir^DGGrafik İndir^XGGrafik Çağır
Medya ve yazıcı ayarı
Etiket genişliği ve uzunluğu, baskı yönü, tüm etiketi ters basma, ölçü birimi ve kaç kopya basılacağı.
^PWBaskı Genişliği^LLEtiket Uzunluğu^POBaskı Yönü^PMAyna Görüntü^LREtiket Tersle^MUÖlçü Birimi^PQBaskı Adedi
Yazdırılabilir ZPL cheat sheet →
Tek sayfada yazdırılabilir özet için ZPL cheat sheet; bir komutu hemen denemek için online ZPL görüntüleyici. ZPL cheat sheet · online ZPL görüntüleyici
Format kontrolü
Format Başlangıcı
Bir etiket formatının başladığını belirtir. Her etiket ^XA ile başlar.
^XZFormat Sonu
Etiket formatını sonlandırır ve etiketi yazdırır/render eder.
^FSAlan Sonlandırıcı
Bir alanı (field) sonlandırır. Her ^FD/^GB/barkod alanı ^FS ile biter.
^FXYorum
Yorum satırı. Render'a etkisi yoktur, atlanır.
^CFVarsayılan Font
Sonraki ^FD alanları için varsayılan font, yükseklik ve genişliği ayarlar.
^CIKarakter Seti
Uluslararası karakter kodlamasını seçer. Motor UTF-8 varsayar (^CI28).
^PWBaskı Genişliği
Etiketin baskı genişliğini (nokta cinsinden) ayarlar.
^LLEtiket Uzunluğu
Etiket uzunluğunu (nokta cinsinden) ayarlar.
^LHEtiket Başlangıcı
Etiketin sol-üst köşe (home) referans noktasını kaydırır.
^LT ·Üstten Kaydırma
Tüm etiketi dikey olarak kaydırır.
^POBaskı Yönü
Baskı yönünü seçer: ^POI tüm etiketi 180° dönük basar. Önizleme de etiketi 180° dönük çizer.
^LREtiket Tersle
Sonraki alanları ters (negatif) basar; ^LRN kapatır.
^LSEtiket Kaydır
TÜM alanları yatayda kaydırır. Kargo etiketlerinde genelde ^LS0 gelir (etkisiz); sıfırdan farklıysa her alan kayar.
^PMAyna Görüntü
Basılabilir alanın tamamını soldan sağa aynalar; ^PMN gelene dek etkindir. Önizleme de aynalı çizer.
^CCFormat Önekini Değiştir
Format komutlarının önekini (^) başka bir karaktere çevirir (~CC de olur); önizleme ve doğrulayıcı yeni öneki uygular.
^CTKontrol Önekini Değiştir
Kontrol komutlarının önekini (~) başka bir karaktere çevirir; ~CT ile de yazılır. Önizleme ve doğrulayıcı değişimi uygular.
Konumlandırma ve metin
Alan Orijini
Sonraki alanı sol-üst köşeden x,y konumuna yerleştirir.
^FTAlan Typeset
Sonraki alanı metnin taban çizgisinden (baseline) konumlandırır.
^FDAlan Verisi
Yazdırılacak metin veya barkod verisini taşır.
^FHHex Göstergesi
Sonraki ^FD içinde _XX hex kaçışlarını etkinleştirir (özel karakterler).
^A ·Font Seçimi
Font, yön ve boyut seçer. ^A0 ölçeklenebilir fonttur.
^FBMetin Bloğu
Metni belirli genişlikte kelime kaydırmalı bloğa yerleştirir (hizalama dahil).
^FWAlan Yönü
Sonraki alanlar için varsayılan döndürme yönünü ayarlar (N/R/I/B).
^FRTers Baskı
Sonraki alanı ters (reverse) renkte basar — koyu zemin üzerine açık.
^FVDeğişken Alan
Alan verisini değişken olarak taşır; motor onu ^FD ile aynı şekilde işler.
^TBMetin Bloğu (genişlik ve yükseklik)
Metni verilen genişlik ve yükseklikte bir bloğa kelime kaydırarak yerleştirir; bloğa sığmayan metin kırpılır (^FB gibi üst üste basılmaz).
^PAGelişmiş Metin Özellikleri
Eksik karakterin nasıl basılacağını, çift yönlü düzeni, şekillendirmeyi ve OpenType'ı açıp kapatır; önizleme son üçünü birlikte uygular.
^CWYazı Tipi Tanımlayıcı
Bir font harfini (A-Z, 0-9) indirilmiş bir fonta bağlar. Önizleme yalnız aynı ZPL'de ~DU ile gönderilen TrueType fontu kullanır.
Grafik çizim
Kutu / Çizgi
Dikdörtgen kutu veya çizgi çizer (genişlik, yükseklik, kalınlık).
^GCDaire
Çember çizer (çap, kalınlık).
^GDÇapraz Çizgi
Köşegen (diyagonal) çizgi çizer.
^GEElips
Elips çizer (genişlik, yükseklik, kalınlık).
^GFGömülü Grafik
Etikete gömülü bitmap grafik (logo/resim) basar.
^IMGörsel Yerleştir
Bellekteki grafiği geçerli ^FO konumuna yerleştirir (^XG ile aynı işi görür).
Barkod
Barkod Varsayılanları
Sonraki barkodlar için modül genişliği, oran ve yüksekliği ayarlar.
^BCCode 128
Code 128 barkodu — kargo ve lojistikte en yaygın doğrusal barkod.
^BEEAN-13
EAN-13 perakende ürün barkodu (son hane otomatik hesaplanır).
^BQQR Kod
QR kod. Veri genellikle ^FDQA,... önekiyle verilir.
^BXData Matrix
Data Matrix 2D barkodu — küçük alana yüksek veri.
^B3Code 39
Code 39 — büyük harf ve rakam kodlayan doğrusal barkod.
^B7PDF417
PDF417 yığın (stacked) barkodu — çok satırlı yüksek veri.
^B1Code 11
Code 11 (USD-8) — telekom ve laboratuvar etiketleri.
^B2Interleaved 2/5
Interleaved 2 of 5 — çift haneli sayısal veri.
^B8EAN-8
EAN-8 — küçük ambalajlar için kısa perakende kodu.
^B9UPC-E
UPC-E — sıkıştırılmış UPC, küçük ambalaj.
^BACode 93
Code 93 — Code 39'un daha yoğun ardılı.
^BIIndustrial 2/5
Industrial 2 of 5 — yalnız sayısal, endüstriyel.
^BJStandard 2/5
Standard 2 of 5 — yalnız sayısal.
^BKCodabar
Codabar — kan bankası, kütüphane, kargo.
^BMMSI
MSI Plessey — raf ve envanter etiketleri.
^BUUPC-A
UPC-A — Kuzey Amerika perakende standardı.
^BRGS1 DataBar
GS1 DataBar (RSS Expanded) — küçük perakende ve taze gıda.
^B0Aztec
Aztec Code — 2D, sessiz bölge gerektirmez.
^BOAztec
Aztec Code (^BO yazımı) — ^B0 ile aynı sembolojiyi üretir.
^BFMicroPDF417
MicroPDF417 — PDF417'nin dar alan için sıkıştırılmış hâli.
^BDMaxiCode
MaxiCode — UPS taşıma etiketlerinin sembolojisi.
Gelişmiş
Seri Numaralandırma
Toplu üretimde alan verisini başlangıç, artış ve doldurma ile serileştirir.
^PQBaskı Adedi
Aynı etiketten kaç kopya üretileceğini, kaç etikette bir duraklanacağını ve seri numarası tekrarını belirtir.
^MU ·Ölçü Birimi
Sonraki komutların ölçü birimini seçer; taban ve hedef nokta yoğunluğu verilirse yazıcı formatı bir çözünürlükten diğerine ölçekler.
^FNAlan Numarası
Şablonlarda değişken alan yer tutucusu (^DF/^XF ile kullanılır).
^DFFormat Kaydet
Bir etiket formatını şablon olarak belleğe kaydeder.
^XFFormat Çağır
Kayıtlı bir şablonu çağırır; ^FN alanlarını değerlerle doldurur.
^XGGrafik Çağır
Belleğe yüklenmiş bir grafiği (~DG/^GF) çağırıp basar.
~DGGrafik İndir
Bir bitmap grafiği yazıcı belleğine yükler (~ önekli kontrol komutu).
^DUFont İndir
TrueType fontu sanal yazıcı belleğine yükler; ^A@ ile o fonta bağlanan alanlar bu veriyi kullanır.
^DYNesne İndir
Grafik ya da font nesnesini sanal yazıcı belleğine yükler (^DG'nin genel hâli).
^EGGrafikleri Sil
Sanal yazıcı belleğindeki TÜM grafikleri siler.
^IDNesne Sil
Bellekten TEK bir nesneyi siler (^EG hepsini siler).
^SFAlan Serileştirme
Alan verisini maskeye göre otomatik artırır (^SN'in maske tabanlı hâli).
Labelixa uzantısı (önizleme)
RFID
RFID Oku/Yaz
RFID etiketine veri yazar ya da ondan okur. Önizleme görselini etkilemez; kodlamayı gerçek RFID yazıcı yapar.
^RS ·RFID Kurulumu
RFID etiket tipi, programlama konumu ve hata davranışını ayarlar.
^RB ·EPC Bit Bölümleme
EPC verisinin bit bölümlerini tanımlar; sonraki ^RF yazımları bu düzeni kullanır.
^RR ·RFID Deneme Sayısı
Başarısız RFID okuma/yazma için deneme sayısını ayarlar.
Yazıcı ayarı
ZPL Kipini Seç
Yazıcının ZPL mi ZPL II mi yorumlayacağını seçer. Yazıcı ayarıdır; önizlemeyi etkilemez.
~TA ·Kopma Konumu Ayarı
Baskıdan sonra etiketin durduğu (koparılacağı ya da kesileceği) konumu nokta satırı cinsinden kaydırır; değer üç haneli yazılır. Önizlemeyi etkilemez.
^ML ·Azami Etiket Uzunluğu
Kalibrasyonun arayacağı azami etiket uzunluğunu ayarlar; gerçek etiket uzunluğuna eşit ya da büyük olmalıdır. Önizlemeyi etkilemez.
^MC ·Bitmap Temizleme
^MCN bitmap'i temizlemez, etiket sonrakinin arka planında basılır. Önizleme her etiketi temiz çizer ve ^MCN'de uyarır.
~PS ·Baskıyı Sürdür
Duraklatılmış yazıcının baskıya devam etmesini sağlar (panelde PAUSE'a basmakla aynı). Önizlemeyi etkilemez.
~JO ·Kafa Testi (ölümcül değil)
Kafa testi başarısız olunca hata gösterir ve baskıyı durdurur ama kapatıp açma gerektirmez (~JN'nin tersi). Önizlemeyi etkilemez.
^SP ·Baskıyı Erken Başlat
Karmaşık etiketlerde baskıyı, format bitmeden verilen nokta satırından başlatır (verim ayarı). Önizlemeyi etkilemez.
^ZZ ·Yazıcı Uykusu
Pilli yazıcıyı verilen boşta kalma süresinden sonra kapatır (yalnız PA400/PT400). Önizlemeyi etkilemez.
~EF ·Saklı Formatları Sil (eski)
Eski ZPL II akışlarında görülen, yazıcıda saklı formatları silen komut; güncel Zebra kılavuzunda yerini ^ID almıştır. Önizlemeyi etkilemez.