Bir tedarikçi faturaları grubu için küçük resim şeridi ilk bakışta doğru görünür: tablo çizgileri yerinde, logo keskin, sütunlar hizalı. İçine yakınlaşın ve müşteri adı bir sıra içi boş kutu olur; toplamlar sütunu ise hiçbir şey söylemeyen harfler taşır. Bozuk her fatura aynı fontu kullanır: ABCDEF+Arial; hepsi de aynı makinedeki bir masaüstü PDF görüntüleyicide düzgün okunur. Küçük resim kodu font adını almış, altı harflik subset etiketini atıp Windows'tan Arial istemiş ve sayfadan gelen ham karakter kodlarını ona vermiş. O kodlar hiçbir zaman Arial'inki değildi. Bir PDF sayfasından sadık bir bitmap almak iki şey gerektirir: sayfanın içerik akışını bir program gibi çalıştırmak ve metni, render makinesinin tesadüfen kurulu olduğu fontlardan değil, dosyada saklanan glif anahatlarından çizmek
Bir PDF sayfası çalıştırdığınız bir şeydir
ISO 32000-1 §8 bir sayfayı bir içerik akışı olarak anlatır: dönüşüm matrisini cm ile değiştiren, grafik durumunu q ve Q ile kaydedip geri yükleyen, yollar kuran, fontları Tf ile seçen, glifleri Tj ile yerleştiren, resimleri ve formları Do ile boyayan operatörler. Dosyada hiçbir pikselin nasıl göründüğünü kaydeden bir şey yoktur. Bitmape ulaşmak için bir şey o akışı, geçerli bir dönüşüm matrisine, bir durum yığınına, bir kırpma yoluna ve dolgu ile kontur renk uzayları çiftine karşı çalıştırmalı, sonra çıkanı rasterize etmelidir
HotPDF'in RenderLoadedPageToBitmap'i o yorumlayıcıdır. Yüklü bir sayfanın operatörlerini gezdirir, matrisi ve grafik durumunu belirtimin tanımladığı gibi tutar, renk uzaylarını çözer, PDF yollarını GDI yollarına çevirir ve glif ilerlemelerini GDI'den değil fontun /Widths dizisinden alır. Image XObject'ler, kütüphanenin çıkarma için kullandığı aynı çözücülerden geçer; böylece HotPDF'in çıkarma için çözebildiği her resim filtresi, JPXDecode ile sıkıştırılmış JPEG 2000 resimleri dahil, render edilen sayfada da belirir
Yüklü bir sayfayı Delphi'de TBitmap'e render etmek
THotPDF.RenderLoadedPageToBitmap(PageIndex, DPI) sıfır tabanlı bir sayfa indeksi ve inç başına nokta cinsinden bir çözünürlük alır (72 DPI bir PDF birimini bir piksele eşler) ve yeni bir 24 bitlik RGB TBitmap döndürür. Aralık dışı bir indeks ya da kurulamayan bir sayfa, özel durum fırlatmak yerine nil döndürür. Bu bir görüntüleyiciye uyar: hasarlı tek sayfayı atlayıp gerisiyle devam etmelidir. Bitmap çağıranındır
var
Pdf: THotPDF;
Bmp: TBitmap;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('report.pdf') > 0 then
begin
Bmp := Pdf.RenderLoadedPageToBitmap(0, 144); // 144 DPI'da ilk sayfa
if Bmp <> nil then
try
Image1.Picture.Assign(Bmp);
finally
Bmp.Free; // döndürülen bitmap çağıranındır
end;
end;
finally
Pdf.Free;
end;
end;
Piksel boyutları sayfanın görünür alanından doğar. Renderer, ISO 32000-1 §14.11.2'nin görünür bölge diye tanımladığı, /MediaBox ile kırpılmış /CropBox'ı alır; kullanılabilir bir crop box yoksa /MediaBox'u kullanır, DPI/72 ile ölçekler ve yukarı yuvarlar. Ayrı bir crop box taşımayan bir US Letter sayfası bu yüzden 72 DPI'da tam olarak 612×792 piksel gelir. 96 DPI'da bir A4 sayfası (595,28×841,89 point) 794×1123'e çıkar; çünkü 793,7 de 1122,5 de yukarı yuvarlanır. 90 ya da 270'lik bir /Rotate genişlik ile yüksekliği takas eder ve PDF'in sol alt başlangıcından GDI'nin sol üstüne çevirme, sayfa matrisinin içinde olur; resim hiçbir son işlem olmadan dik gelir
DPI tek ölçekleme düğmesidir ve olağan işleri karşılar. 36 ya da 48 DPI'daki küçük resimler küçüktür ve hızlıdır. 96 ya da 144 DPI'lık bir ekran önizlemesi tipik ekran yoğunluğuyla uyuşur. 300 DPI'lık export baskı kalitesinde çıktı verir; her Letter sayfası için 2550×3300'lük bir bitmap pahasına, piksel başına üç bayttan her biri kabaca 24 MiB
İkame fontlar neden yanlış glifler çizer?
Render edilen bir PDF'teki yanlış glifler neredeyse her zaman, rasterizer'ın dosyaya gömülü font yerine kurulu bir font takması anlamına gelir. Fatura örneğindeki kestirme caziptir çünkü çoğu zaman işe yarar: /BaseFont'tan subset önekini soyun, kalan adla bir GDI fontu isteyin, dizeyi çizin. Standart kodlamalı sıradan Arial ya da Times New Roman metninde kimse şikâyet etmez
Önce subset fontlar kırar. Bir subset, belgenin kullandığı kırklık glifi taşıyor olabilir ve glifler o dosyaya özel bir sırada numaralanmıştır; kod 1 "T" ve kod 2 "h" olabilir. Kurulu bir font bunu bilemez. Özel kodlamalar, sembol ve barkod fontları ve render makinesinde eksik olan her yazı yüzü aynı nedenle başarısız olur. Ve ikame her karakteri taşısa bile ilerleme genişlikleri gömülü yüzden farklıdır; satırlar uzayıp kısalır ve sağa yaslı sütunlar hizadan çıkar
Metni gömülü font programından çizmek
HotPDF metni PDF'te saklanan font programlarından çizer. Bir font gömülü bir TrueType programı (/FontFile2) ya da bir CFF programı (/FontFile3) taşıdığında her glif o veriden ana hatlanır ve GDI yolu olarak doldurulur; font boyutu, metin matrisi ve geçerli dönüşüm matrisi tek bir dönüşümde bileştirilir. Subset fontlar, özel kodlamalar ve makinenin hiç görmediği yüzler gerçek şekilleriyle çıkar. Bir karakter kodunun glife ulaşması font türüne bağlıdır ve her türün kendi tuzağı vardır:
- TrueType anahatları: konturlar
glyfvelocatablolarından gelir. İkinci dereceden bölümler, GDI'nin çizdiği kübik Bézier'lere yükseltilir — bu kesin bir dönüşümdür —, art arda iki eğri-dışı nokta arasındaki ima edilmiş eğri-üzeri nokta yeniden kurulur ve bileşik glifler, her bileşen dönüşümü uygulanarak bileşenlerine özyinelemeli iner - CID anahtarlı TrueType:
CIDFontType2üzerindekiType0fontlar glif kimliklerine/CIDToGIDMapüzerinden ulaşır — yaIdentity(girdi eksikken de varsayılan budur) ya da açık bir harita akışı — ve ilerlemeleri/Wile/DW'den alır; böylece iki baytlıkIdentity-Hmetni doğru adım atar. Önceden tanımlı CJK CMap'leri ve gömülü CMap akışları, aramadan önce değişken uzunluklu kodları çözer - CFF programları:
Type1C,CIDFontType0Cve OpenType kapsayıcısına sarılı CFF, çizgileri, eğrileri, flex ailesini, ip maskelerini ve alt rutin yanlılığı uygulanmış yerel ile global alt rutin çağrılarını ele alan bir Type 2 charstring yorumlayıcısından geçer. CID anahtarlı programlar her kodu fontun charset'i üzerinden eşler — glif sırası CID sırasından farklı subsetler için önemli — ve glif başına özel sözlüğüFDArrayveFDSelectile seçer - Basit TrueType fontlar: tek baytlık kodlar gömülü
cmap'ten geçer; önce Unicode alt tabloları (3,1) ve (3,10), sonra (3,0) sembol alt tablosu — hem doğrudan hem sembol fontlarının kullandığı U+F000 aynasında — en son eski Macintosh (1,0) tablosu denenir
Bunun üstünde iki kural daha oturur. Basit bir fontun /Encoding sözlüğü, ISO 32000-1 §9.6.6'nın öngördüğü sırada çözülür: /Differences temel kodlamayı ezer, o da programın gömülü eşlemesini ezer. TeX ve öteki PostScript kökenli araç zincirleri buna yoğun yaslanır; sırayı yanlış kurmak, yanlış glifin en zor fark edildiği tam da matematik ve sembol metnini karıştırır. Type3 fontların glifleri kendi başına küçük içerik akışlarıdır ve aynı yorumlayıcıyla, font matrisi, font boyutu ve metin matrisi bileştirilerek yeniden oynatılır; glif uzayındaki /Widths, §9.6.5'in istediği gibi /FontMatrix'ten geçer ve d1 sınırlayıcı kutusu bildiren bir glif prosedürü ona kırpılır; böylece bozuk bir barkod glifi hücresinin dışına boyayamaz
Tek bir kod eşlenemediğinde — program hasarlıysa ya da subset o gliften yoksunsa — o tek karakter aynı adlı kurulu fontla çizilir ve dizinin gerisi gömülü anahatları kullanmaya devam eder. Tüm diziyi düşmek sorunu gizler; tek tuhaf harf fark edilmesi kolaydır. Kullanılabilir gömülü programı olmayan fontlar, sistem yüzleriyle gömülü olmayan fontları render etme makalesinde anlatılan kurulu font yolunu izler
Tekrarlanan render'ları nasıl hızlı tutarsınız?
Etkileşimli her şey için düz metot yerine RenderLoadedPageToBitmapCached'i çağırın. Son render edilen sayfaları, sayfa indeksi, DPI ve geçerli render ayarlarıyla (renk niyeti, overprint önizleme, fallback politikası ve hangi optional content katmanlarının görünür olduğu) anahtarlanan en-yakın-kullanılan bir önbellekte tutar; isabet, içerik akışını yeniden yorumlamadan taze, çağıranın sahibi olduğu bir kopya verir. İki sayfa arasında gidip gelmek ya da aynı sayfayı aynı DPI'da yeniden isteyen bir boyutlandırma her seferinde önbelleğe vurur. Her sayfayı bir kez ziyaret eden tek seferlik bir export için düz RenderLoadedPageToBitmap daha iyidir; çünkü önbellekli çeşit, döndürdüğü her bitmap'i kopyalar ve kimse bir daha istemeyecek sayfaları tutar
// Küçük resim şeridi: ilk geçiş render eder, geriye kaydırma önbelleğe vurur
Pdf.RenderCacheCapacity := 32; // girdi sınırı; varsayılan 8
for I := 0 to Pdf.LoadedPageCount - 1 do
begin
Bmp := Pdf.RenderLoadedPageToBitmapCached(I, 48);
if Bmp <> nil then
try
ThumbList.AddThumbnail(I, Bmp); // sizin kendi UI kodunuz
finally
Bmp.Free;
end;
end;
// 300 DPI sayfaları da önbellekliyor musunuz? Raster önbelleğine daha geniş bir bayt bütçesi verin
// (Policy: THPDFCacheAdmissionPolicy)
if Pdf.GetCacheAdmissionPolicy(clkRaster, Policy) then
begin
Policy.MaxTotalBytes := Int64(512) * 1024 * 1024;
Pdf.SetCacheAdmissionPolicy(clkRaster, Policy);
end;
// Sayfa içeriğini doğrudan değiştirdikten sonra:
Pdf.InvalidateRenderedPageCache; // sonraki render düzenlemeyi yansıtır
RenderCacheCapacity iki sınırdan yalnızca biridir. Raster önbelleğinin bir bayt bütçesi de vardır: varsayılan 128 MiB, girdi başına 64 MiB tavan ve bütçelerken piksel başına dört bayt sayar. Bir görüntüleyicinin Letter sayfalarını 300 DPI'da önbelleklediğini düşünün: her girdi kabaca 32 MiB sayılır, RenderCacheCapacity ne derse desin üçü sığar. 48 DPI'da aynı sayfa kabaca 0,82 MiB sayılır ve yukarıdaki döngüden 32 küçük resmin tamamı 27 MiB'nin altında yerleşik kalır. Önbellek dolduğunda bir kez istenen sayfa, sık istenen bir sayfayı yerinden etmeyebilir; yine de render edilip döndürülür, yalnızca tutulmaz. Görüntüleyici sayfaları öngörülebilir bir sırada çeviriyorsa PrefetchLoadedPages aynı önbelleği kullanıcıdan önce bir işçi iş parçacığında doldurur
Yeni bir belge yüklemek önbelleği temizler. Kütüphanenin kendi sayfa düzenleme çağrılarından birkaçı, FlattenLoadedFormFields gibi, etkilenen sayfaları kendiliğinden düşürür; sayfa nesnelerine ya da içerik akışlarına doğrudan yaptığınız her değişiklikten sonra InvalidateRenderedPageCache'i çağırın, çünkü önbellek bir sayfanın arkasındaki baytların değiştiğini bilemez. Altta çözülmüş image XObject'ler için ikinci bir depo durur; ImageCacheMaxBytes ile sınırlıdır (varsayılan 32 MiB) ve her sayfada yinelenen bir logo ya da antetli kağıt, Do operatörü başına değil belge yüklemesi başına bir kez çözülür. InvalidateRenderedPageCache onu da temizler. Küçük resimlerin uygulama yeniden başlamasına rağmen yaşaması gerekiyorsa render önbelleğinin disk katmanı o durumu karşılar
Bir sayfanın ne zaman yaklaştırıldığını öğrenmek
Çoğu sayfa hiçbir yedeğe ulaşmaz; çünkü renderer metin ve resimden çok daha fazlasını karşılar. CalGray, CalRGB, Lab ve ICC tabanlı renk uzayları etkin render niyetiyle dönüştürülür — RenderColourIntent bunu ezebilir — ve ConfigureRenderICCWorkflow yumuşak prova için prova ve çıkış ICC profilleri alır. İndeksli paletler, Separation ve DeviceN tonları ve örneklenmiş Type 0 işlev renk aramaları karşılanır. İşlev tabanlı, eksenel, radyal ve mesh gölgelemeler hem sh operatörüyle hem gölgeleme desenleriyle render edilir; saydamlık grupları, knockout grupları ve alfa ya da parlaklık yumuşak maskeleri, blend modlu gruplar ve parlaklık maskeleri makalesinde anlatıldığı gibi kendi karışım modlarıyla bileşenir
Gerçek dünya dosyaları hâlâ tam çizilemeyecek şeyler içerir: sayfanın adını andığı ama hiç tanımlamadığı bir kaynak, verisi çözülemeyen bir resim, kendini boyayan bir Form XObject. RenderFallbackPolicy o zaman ne olacağına karar verir. Varsayılan rfpIgnore en yakın yaklaşımı çizer ve yoluna devam eder. rfpReport aynısını yapar ama her yedek için bir teşhis kaydeder; RenderFallbackDiagnosticLimit girdisine kadar (varsayılan 256). rfpStrict yaklaşık bir bitmap döndürmek yerine özel durum fırlatır. Form iç içe geçmesi 32 düzeyde durur ve kendine atıf yapan bir form atlanır; böylece bozuk ya da düşmanca bir dosya sınırsız özyineleyemez
// rfpReport ile THPDFRenderFallbackDiagnostics HPDFPageRenderer içinde bildirilir
var
Diags: THPDFRenderFallbackDiagnostics;
J: Integer;
begin
Pdf.RenderFallbackPolicy := rfpReport;
Bmp := Pdf.RenderLoadedPageToBitmap(PageIndex, 150);
try
Diags := Pdf.GetLastRenderFallbackDiagnostics;
for J := 0 to High(Diags) do
Log.Add(Format('page %d: %s %s - %s', [PageIndex + 1,
string(Diags[J].OperatorName), string(Diags[J].ObjectName),
string(Diags[J].Reason)]));
if Pdf.LastRenderFallbackDroppedCount > 0 then
Log.Add(Format('%d more fallbacks not recorded',
[Pdf.LastRenderFallbackDroppedCount]));
finally
Bmp.Free; // nil üzerinde Free güvenlidir
end;
end;
QA ve veri alım yapılarını rfpReport ile çalıştırın. Bitmap, rfpIgnore'ın ürettiğiyle özdeştir ve günlük, 14. sayfa tuhaf görünüyor diye bir müşteri haber vermeden önce hangi sayfaların yaklaştırıldığını ve nedenini gösterir. rfpStrict'i arşiv dönüşümü için saklayın; sessizce yaklaştırılmış bir sayfanın başarısız olandan kötü olduğu yer orasıdır. Önbellek isabeti, o sayfa ilk render edildiğinde kaydedilen teşhisleri geri getirir; böylece GetLastRenderFallbackDiagnostics, önbellekli çeşit iş yapıp yapmadığından bağımsız aynı cevabı verir
RenderLoadedPageToBitmap, önbellekli çeşidi ve gömülü glif metin yolu, Delphi ve C++Builder için harici DLL taşımayan yerel bir VCL kütüphanesi olan HotPDF Delphi Component'in parçasıdır; render ettiğiniz aynı yüklü belgelerden oluşturma, düzenleme ve metin çıkarma da yapar