Teknik Makale

Data Matrix ve PDF417'de UTF-8: ECI 26 İşaretçisi

Bir depo etiketi, alıcıyı Müller GmbH, Köln olarak bir Data Matrix sembolünde UTF-8 ile saklar ve depodaki her el tarayıcısı bunu Müller GmbH, Köln olarak geri okur. PDFlibPas'ın BarcodePayloadEncoding özelliğini bpeUTF8WithECI yapmak, verinin önüne bir ECI 000026 işaretçisi koyar; bu işaretçi, Data Matrix ve PDF417 okuyucularına baytları UTF-8 olarak çözmelerini söyler

Bir UTF-8 yükü neden Müller olarak çözülür?

Sembol karakter kümesi bildirimi taşımaz, bu yüzden okuyucu sembolojinin varsayılan tek baytlık karakter kümesine geri döner; Data Matrix için bu ISO-8859-1'dir. UTF-8 ü iki bayttır, C3 BC, ve ISO-8859-1 bunları à ve ¼ olarak eşler; ö da aynı yolla ö olur. Baytların kendileri sapasağlamdır. Extended Channel Interpretation, barkod dünyasının karakter kümesi bildirimidir. AIM ECI kayıt defteri karakter kümelerine numara atar; bunlardan 000026 UTF-8 içindir ve bir ECI belirteciyle açılan sembol, uyumlu okuyucuya ondan sonraki her şeyi bu karakter kümesinde çözmesini söyler. Belirteç sembole sıradan veri gibi görünür. Burada konuşulan her iki sembolojide de iki kod sözcüğü kaplar, kapasiteye sayılır ve arkasındaki yük ile aynı 2D barkodlar için Reed-Solomon hata düzeltmesi altında korunur

PDFlibPas Delphi barkodlarında özdeş UTF-8 baytları iki farklı biçimde nasıl çözülür: ECI işaretçisi yokken ISO-8859-1 tahmini, ECI 000026 varken UTF-8 çözümü yapılır
sembol yalnızca bayt saklar, o yüzden baytların ISO-8859-1 tahmini değil UTF-8 olduğunu okuyucuya söyleyen şey ECI 000026 belirtecidir

Data Matrix ve PDF417'de ECI kod sözcüğü konumları

Her sembolojinin işaretçi için sabit bir yuvası vardır. Başka bir yere koyarsanız sembol ya hiç çözülmez ya da başında çöp karakterlerle çözülür:

Delphi ile PDFlibPas Data Matrix, GS1 Data Matrix ve PDF417 sembollerinde ECI UTF-8 işaretçisinin kod sözcüğü yuvaları; her biri yükten önce sabit konumda
her semboloji ECI belirtecini sabit bir başlangıç yuvasına sabitler ve PDFlibPas konuma bağlı kodlamalar çalışmadan önce onu yazar
  • Data Matrix (ISO/IEC 16022): önce 241 kod sözcüğü, ardından 127 altı değerler için kullanılan tek kod sözcüklük biçimde ECI numarası artı bir, yani UTF-8 için 27. Veri akışını o açar
  • GS1 Data Matrix: FNC1 (232 kod sözcüğü) ilk konumda kalmalıdır, bu yüzden siz bir tane istersem PDFlibPas işaretçiyi tam onun ardına koyar; GS1 eleman dizeleri zaten ASCII'nin bir alt kümesinden gelir ve işaretçi olmadan da aynı şekilde okunur
  • PDF417 (ISO/IEC 15438): 0 kod sözcüğü sembol uzunluk tanımlayıcısıdır ve işaretçi, 927 ve 26 kod sözcükleri olarak ilk veri kod sözcüğünden önce gelir

Base 256 zor durumdur. O kodlama, rastgele baytlar için kompakt Data Matrix kipi, her kod sözcüğünü semboldki mutlak konumundan türetilen sözde rastgele bir değerle karıştırır: (149 × position mod 255) + 1. Karıştırmadan sonra işaretçiyi başa eklerseniz arkasındaki her bayt, okuyucunun gördüğünden iki konum önceki bir konum için karıştırılmış olur ve bütün yük yanlış değerlere çözülür. EDIFACT kodlamasında aynı bağımlılığın daha yumuşak bir hâli vardır — işaretçi öne geçtiğinde unlatch konumu iki kayar. PDFlibPas işaretçiyi kod sözcüğü akışına her iki adımdan önce yazar ve sembol boyutunu seçen kapasite kontrolü onu zaten hesaba katar. Her iki semboloji için etiket kodu:

uses
  SysUtils, PDFlibrary;

procedure PrintConsigneeLabel(const FileName: string);
var
  Pdf: TPDFlib;
begin
  Pdf := TPDFlib.Create;
  try
    Pdf.NewDocument;                                // sayfa 1'i oluşturur ve seçer
    Pdf.SetPageSize('A4');
    Pdf.SetMeasurementUnits(1);                     // milimetre
    Pdf.SetOrigin(1);                               // Top üst kenardan ölçülür

    Pdf.BarcodePayloadEncoding := bpeUTF8WithECI;   // UTF-8 baytları + ECI 000026
    if Pdf.DrawDataMatrixSymbol(20, 20, 0.5, 'Müller GmbH, Köln',
      1,      // Encoding: 1 = ASCII kodlaması
      0,      // SymbolSize: 0 = tablodaki uyan ilk boyut
      100) <> 1 then                                // normal yönelim, varsayılan 1 modüllük sessiz bölge
      raise Exception.CreateFmt('Data Matrix failed (%d)', [Pdf.LastErrorCode]);

    if Pdf.DrawPDF417SymbolEx(20, 50, 'Zustellung: Müller GmbH, Köln',
      0, 0, 0,  // yönelim, sütunlar, satırlar: otomatik
      -1,       // hata düzeyi otomatik
      0.3, 3.0) <> 1 then
      raise Exception.Create('PDF417 failed');

    // ECI farkında bir tarayıcı her iki sembol için de Almanca metni döndürmeli
    Pdf.BarcodePayloadEncoding := bpeSystemANSI;    // varsayılana geri dön
    Pdf.SaveToFile(FileName);
  finally
    Pdf.Free;
  end;
end;

NewDocument sayfa 1'i zaten oluşturur ve seçer, dolayısıyla semboller bir NewPage çağrısı olmadan ilk sayfaya düşer. SetOrigin(1) başlangıç noktasını sol üst köşeye taşır; bu, Top'un sembolün üst kenarının sayfanın üstünden uzaklığı olduğu anlamına gelir. Varsayılan sol alt başlangıç noktasında 10 mm'lik bir Top, o kenarı kâğıdın altından 10 mm yukarıya koyar ve 11 mm'lik bir sembol kâğıdın dışına taşar. DrawDataMatrixSymbol başarı durumunda 1 döndürür. Kodlayamadığı verilerde — işaretçi sayıldığında en büyük sembole bile sığmayan bir yük ya da istediğiniz sabit boyut — 0 döndürür, LastErrorCode'u 302 yapar ve hiçbir şey çizmez; bu yüzden örnek 1 dışındaki her değeri hata sayar

Her etiket ECI işaretçisi taşımalı mı?

Hayır, ve varsayılan bunu yansıtır. BarcodePayloadEncoding üç değer alır ve her biri farklı bir okuyucu kitlesine uyar:

  • bpeSystemANSI (varsayılan) metni sistem ANSI kod sayfasından çevirir ve işaretçi yazmaz; PDFlibPas QR, PDF417 ve Data Matrix işlevleriyle kurulan etiket düzenleri bunu bekler
  • bpeUTF8 işaretçisiz UTF-8 baytları yazar; kendi yazılımınızın barkodu okuduğu ve zaten UTF-8 varsaydığı kapalı sistemler içindir
  • bpeUTF8WithECI UTF-8 baytları yazar ve onları ECI 000026 ile etiketler

Her şeye etiket takmanın bedeli okuyucu desteğidir. ECI işlemesi birçok tarayıcıda bir yapılandırma seçeneğidir ve ayara bağlı olarak bir cihaz sembolü reddedebilir ya da belirteci metin olarak ana makineye geçirebilir: AIM kuralı ters eğik çizgi artı altı basamaktır, yani uygulama \000026Müller GmbH, Köln alır. İşaretçiyi sembol başına, ASCII dışı metin içeren yükler için açın ve tarayıcı profili değişikliğiyle birlikte yayına alın. Her ad okuyucularınızın varsaydığı kod sayfasına uyuyorsa tek baytlık yük hâlâ makul bir seçimdir. ü, hem Windows-1252'de hem ISO-8859-1'de FC baytıdır; bu yüzden Batı Avrupa Windows sisteminde bpeSystemANSI altında yazılmış bir Almanca adres, ECI'den haberi olmayan bir Data Matrix okuyucuda doğru çözülür. Japonca metnin böyle bir geri dönüşü yoktur

Sembol boyutu: otomatik seçim, sabit şablonlar ve dikdörtgenler

İşaretçinin iki kod sözcüğü nadiren yalnız başına iş görür. ASCII kodlamasında bpeSystemANSI altındaki alıcı satırı, ü ve ö'yu ikişer kod sözcüğe mal olan 127 üstü tek baytlar olarak taşır ve satırın tamamı 19 kod sözcüğe mal olur; bu, 22 veri kod sözcüğü olan 20×20 sembole sığar. UTF-8 olarak bu iki harf dört yüksek bayta dönüşür ve satır 23'e çıkar. İşaretçiyle 25 olur. Bu da 22×22 gerektirir; adım zaten UTF-8 baytlarından gelir, çünkü 23, 20×20'yi aşıyor. SymbolSize'ı 9'a (20×20) sabitleyen bir şablon, kodlama değişir değişmez DrawDataMatrixSymbol'ten 0 ve 302 hatası alır, barkod yuvasına hiçbir şey çizilmez

Otomatik boyutlandırma şekli de değiştirebilir. SymbolSize 0 iken PDFlibPas, ISO/IEC 16022 boyut listesini sırayla gezer ve akışı tutan kapasiteye sahip ilk girdiyi alır. Altı dikdörtgen boyut listede karelerin arasına serpiştirilmiştir. 26×26 sembolü dolduran bir yük (44 veri kod sözcüğü) işaretçiyle 46 ister ve 46 tutan sıradaki girdi 49 ile 16×48'dir, 62 ile 32×32'den önce gelir. Modül başına 0,5 mm'de 13 mm'lik bir kare 8 × 24 mm'lik bir şeride dönüşür. Dolu bir 22×22 de aynısını yapar: 30 kod sözcük artı ikisi 16×36'ya düşer. Küçük yükler kare kalır — 10×10'u dolduran üç kod sözcük beşe çıkar ve listede 8×18'den önce gelen 12×12'ye sığar. Etiketiniz kare bir yuva ayırdıysa SymbolSize'ı karşılayabildiğiniz kareye (32×32 için 16) sabitleyin ve bir ad için çok uzun olduğunda 302 hatası sizi uyarsın; otomatik boyutlandırma her iki şekli de alabilen düzenlere uyar

PDF417 başka bir kuralla büyür. ErrorLevel -1 iken kodlayıcı, hata düzeltmesini ISO/IEC 15438'in önerilen asgari düzeylerine göre planlar; bu düzeyler uzunluk tanımlayıcısı dahil 41, 161 ve 321 kod sözcükte artar. 39 kod sözcüklük bir akış işaretçiyle 41 olur, asgari düzey 2'den 3'e kayar ve planlanan hata düzeltme bloğu 8'den 16 kod sözcüğe çıkar. Bu, on fazladan kod sözcüktür. Sütun ve satırlar otomatikken kodlayıcı dikdörtgeni bu daha büyük toplama göre dizer; dolayısıyla bir eşiğin hemen altında duran yük, iki işaretçi kod sözcüğünün ima ettiğinden daha fazla alan kaybeder

Hangi kodlama bir UTF-8 Data Matrix'i küçük tutar?

İki maliyeti doğrudan karşılaştırın. ASCII kodlaması bir rakam çiftini tek kod sözcüğe paketler ve düz ASCII'yi karakter başına bir kod sözcüğe koyar, ama 127 üstü her bayt ikisine mal olur: bir Upper Shift (235) ve baytın 127 eksiği. Base 256 bir kez kilitleme ve uzunluk alanı öder — 249 bayta kadar bir uzunluk kod sözcüğü, ötesinde iki — sonra bayt başına bir kod sözcük, rakam paketlemesi yok. Rakam dizisi olmayan metin için Base 256, yük üç yüksek bayt tutar tutmaz kazanır. Müller satırı zaten tutar: 23'e karşı 21 kod sözcük. Uzun sayısal diziler dengeyi ASCII'ye geri iter, çünkü her rakam çifti orada bir kod sözcük kazandırır. Aşağıdaki yardımcı iki maliyeti de sayar ve daha ucuz kiple çizer; saf ASCII hiç işaretçi almaz, çünkü her karakter kümesinde özdeş okunur:

// Daha ucuz kodlamayla Unicode metin için bir Data Matrix çiz
function DrawUnicodeDataMatrix(Pdf: TPDFlib; Left, Top, ModuleSize: Double;
  const Text: WideString): Integer;
var
  Bytes: UTF8String;
  I, HighBytes, AsciiCost, Base256Cost, Mode: Integer;
  Saved: TPDFlibBarcodePayloadEncoding;
begin
  Bytes := UTF8Encode(Text);
  HighBytes := 0;
  AsciiCost := 0;
  I := 1;
  while I <= Length(Bytes) do
  begin
    if (I < Length(Bytes)) and (Bytes[I] >= '0') and (Bytes[I] <= '9') and
       (Bytes[I + 1] >= '0') and (Bytes[I + 1] <= '9') then
    begin
      Inc(AsciiCost);                    // rakam çifti: bir kod sözcük
      Inc(I, 2);
      Continue;
    end;
    if Ord(Bytes[I]) > 127 then
    begin
      Inc(HighBytes);
      Inc(AsciiCost, 2);                 // Upper Shift + (bayt - 127)
    end
    else
      Inc(AsciiCost);
    Inc(I);
  end;
  if Length(Bytes) <= 249 then
    Base256Cost := Length(Bytes) + 2     // kilitleme + bir uzunluk kod sözcüğü
  else
    Base256Cost := Length(Bytes) + 3;    // kilitleme + iki uzunluk kod sözcüğü

  Saved := Pdf.BarcodePayloadEncoding;
  try
    if HighBytes = 0 then
    begin
      Pdf.BarcodePayloadEncoding := bpeSystemANSI;  // saf ASCII: işaretçi yok
      Mode := 1;
    end
    else
    begin
      Pdf.BarcodePayloadEncoding := bpeUTF8WithECI;
      if Base256Cost < AsciiCost then
        Mode := 3                        // Base 256
      else
        Mode := 1;                       // ASCII
    end;
    Result := Pdf.DrawDataMatrixSymbol(Left, Top, ModuleSize, Text, Mode, 0, 100);
  finally
    Pdf.BarcodePayloadEncoding := Saved;
  end;
end;

東京都千代田区 için UTF-8 biçimi 21 bayttır, hepsi 127 üstü. İşaretçiyle Base 256 25 veri kod sözcüğü, ASCII kodlaması ise 44 ister; bu da kapasite tablosuna göre aynı modül boyutunda 22×22 sembole karşı 26×26 semboldür. O 26×26 tamamen dolar. Bir kod sözcük daha ve 16×48'e atlar. GS1 yükleri (kip 7) yardımcının dışında kalır, çünkü eleman dizeleri ASCII'dir. QR kodları veri kipini DrawQRCode'un EncodeOptions argümanından alır ve PDFlibPas'ın çizdiği Aztec sembolleri, yük baytları en az bir ASCII dışı karakterle geçerli UTF-8 olduğunda kendiliğinden bir ECI 26 bayrağı taşır

Delphi'de PDFlibPas Data Matrix barkodları için ASCII ve Base 256 kodlama maliyetleri; hesaplanmış kod sözcük toplamları ve yardımcının seçtiği kip
üç veya daha fazla yüksek bayt ortaya çıktığında Base 256 kazanır, rakam ağırlıklı yükler ise maliyeti ASCII kodlamasına geri savurur

Müller satırı için işaretçi iki kod sözcüğe mal olur; 20×20'den 22×22'ye geçiş — 0,5 mm modüllerde 10 mm'den 11 mm'ye — ise UTF-8 baytlarından kaynaklanır. Etiket yuvanızda o fazladan milimetre varsa, alıcı sembol çizilmeden hemen önce PDFlibPas Delphi PDF Library'nin TPDFlib örneğinde BarcodePayloadEncoding'i bpeUTF8WithECI yapın ve aynı sayfadaki eski semboller için bpeSystemANSI'ye geri alın