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
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:
- 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 beklerbpeUTF8işaretçisiz UTF-8 baytları yazar; kendi yazılımınızın barkodu okuduğu ve zaten UTF-8 varsaydığı kapalı sistemler içindirbpeUTF8WithECIUTF-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
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