Masanıza bir istek düşüyor: zaten oluşturulmuş bir dizi hesap dökümünü alın, hesap numaralarını karartın ve kağıt tasarrufu için sayfa başına iki sayfa olarak gönderin. Bu işin iki yarısı da sizin üretmediğiniz bir PDF üzerinde içerik akışı cerrahisidir, bu yüzden üzerinde çizim yapacağınız dost bir sayfa tuvali yoktur ve yaslanabileceğiniz bir font yöneticisi de yoktur. Doğrudan açılmış belgenin nesne grafiğini düzenliyor, başka bir aracın yerleştirdiği bir sayfaya ham çizim işleçleri ekliyorsunuz. HotPDF bunun için tam olarak iki giriş noktası sunar ve daha tehlikeli olan, zararsız görünenidir
HotPDF, Delphi ve C++Builder için yerel bir VCL PDF bileşenidir ve açılmış belge API'si, disken açtığınız, sıfırdan oluşturmadığınız bir sayfada yeni içerik üreten yöntemler içerir. Burada konu olan ikisi: bir bölgenin üzerine opak bir dikdörtgen boyayan RedactLoadedRect ve bir sayfayı ölçekleyip diğerine çizen StitchLoadedPage. İkisi de ISO 32000-1 §8.5 içerik akışı işleçlerini sayfanın /Contents akışına yazarak çalışır. Bu işleçlerin ne yaptığını ve en az onun kadar önemlisi ne yapmadığını anlamak, çalışan bir araçla veri sızıntısı arasındaki farktır
Açılmış bir sayfaya işleç eklemek
Bir sayfayı normal HotPDF API'siyle oluşturduğunuzda, içerik akışının sahibi bileşendir ve TextOut ile vektör çağrılarınızı sizin için serileştirir. Açılmış bir sayfa farklıdır: /Contents mevcut bir akış nesnesidir, paylaşımı olabilir, bir içerik dizisinin parçası olabilir ve orada duranı bozmadan bu akışa ek yapmanız gerekir. Üç küçük yardımcı bunu güvenli kılar. NewIndirectStream boş bir tampon ve /Length 0 girdisiyle taze bir dolaylı THPDFStreamObject ayırır; ResolveLoadedStream dolaylı bir başvuruyu altta yatan akışa kadar izler; AppendLoadedStream akışın sonuna ham baytları yazar ve kaydedilen nesnenin biçimi düzgün kalsın diye /Length değerini yeniden yazar
Her iki genel yöntemin izlediği desen aynıdır. Sayfanın /Contents değerini bulun, bunu bir akışa çözün ve kullanılabilir bir akış yoksa bir tane oluşturup ekleyin. Ardından işleçleri ekleyin. Yeni baytlar akışın sonuna eklendiği için, boyama modeli bunların özgün düzenin çizdiği her şeyin üzerinde görünmesini garanti eder. Sade kırmızı maske dikdörtgeninin arkasındaki mekanizma budur ve aynı zamanda o dikdörtgenin çoğu kişinin sandığı şey olmamasının nedenidir
RedactLoadedRect: silen değil, örten bir kaplama
RedactLoadedRect sıfır tabanlı bir sayfa dizini, kullanıcı uzayında dört koordinat ve 0 ile 1 arasında üç renk bileşeni alır:
var
Pdf: THotPDF;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('statement.pdf') > 0 then
begin
// 1. sayfadaki hesap numarası bandını düz siyahla kapat.
// Koordinatlar PDF kullanıcı alanındadır: orijin sol altta, birim nokta.
Pdf.RedactLoadedRect(0, 56, 690, 320, 706, 0, 0, 0);
Pdf.SaveLoadedDocument('statement-covered.pdf');
end;
finally
Pdf.Free;
end;
end;
İçeride yöntem içerik akışına üç işleç yazar: DeviceRGB ile bir dolgu rengi ayarı (r g b rg), bir dikdörtgen yolu (x y w h re) ve bir dolgu (f). Genişlik ve yükseklik X2 - X1 ve Y2 - Y1 olarak türetilir, yani siz iki karşı köşe verirsiniz ve kapsamı yönteme hesaplattırırsınız. Renk için 0, 0, 0 verirseniz siyah bir şerit elde edersiniz; beyaz sayfaya uyan beyaz bir şerit istiyorsanız 1, 1, 1 verin. Koordinatlar yüklediğiniz sayfanın kendi kullanıcı uzayıdır, yani başlangıç sol alt köşedir ve birimler puntodur. Bu aynı zamanda bir şeyleri doğru yerleştirmek için sayfanın /MediaBox değerine ihtiyaç duyduğunuz anlamına gelir; GetLoadedPageBox ile pbMediaBox size bunu verir
Bunu iki kez okuyun: doldurulmuş bir dikdörtgen içeriği görsel olarak örter, ama onu silmez. Dikdörtgenin altındaki metin, görüntü ya da vektör sanat hâlâ PDF'de durur, hâlâ nesne grafiğindedir, sayfayı kopyalayan, bir metin çıkarıcı çalıştıran ya da içerik akışından dikdörtgeninizi basitçe silen herkes tarafından hâlâ çıkarılabilir durumdadır. Bu, hukuki ya da güvenlik anlamında redaksiyon değil, görsel maskelemedir. Gerçekten hassas veriyi gizliyorsanız - hesap numaraları, tıbbi kayıtlar, kimlikler, düzenlemeye tabi her şey - üstünü siyah bir kutuyla kapatıp dosyayı göndermek, gün yüzüne çıkmayı bekleyen bir veri sızıntısıdır. Gerçek redaksiyon, alttaki içerik nesnelerini kaldırmayı gerektirir, üstlerini boyamayı değil
Yöntemin adı "Redact" diyor ve bu, sonucun nasıl yanlış okunacağına dair yararlı bir uyarıdır; neyi sildiğine dair bir söz değildir. RedactLoadedRect tasarımı gereği görsel bir redaksiyon ilkelidir; içeriği kaldıran redaksiyon ayrı bir işlemdir ve içerik akışının mevcut işleçlerini gezip yeniden yazar. Güvenli kural dar daredir: RedactLoadedRect'i hassas olmayan kozmetik maskeleme için kullanın — taslak filigranı gizlemek, ekran görüntüsü almadan önce bir bölgeyi kapatmak, dahil bir provada eski logosu örtmek gibi. Kutunun altındaki şey sızdığında fark yaratacaksa bu yöntem yanlış araçtır ve doğru cevap, belgeyi verisiz yeniden üretmek ya da gerçek bir içerik kaldırma hattı kullanmaktır
StitchLoadedPage: ölçekle, ötele, çiz
N-up yerleştirme daha dost bir problemdir, çünkü hiçbir şey gizlenmez, yalnızca yeniden düzenlenir. StitchLoadedPage sıfır tabanlı bir hedef sayfa dizini, bir kaynak sayfa dizini, bir X/Y ofseti ve bir ölçek katsayısı alır, kaynak sayfayı o konumda ve o boyutta hedefin üzerine çizer:
// Sayfa 2'yi (dizin 1) sayfa 1'in (dizin 0) üzerine bindir,
// %70 ölçekli ve sağ üste itilmiş.
Pdf.StitchLoadedPage(0, 1, 40, 380, 0.7);
// Kolaylık 2'li: kaynak sayfa hedefin sağ yarısında.
Pdf.StitchLoadedPageSideBySide(0, 1);
Eklediği işlemci dizisi standart bir dönüştür ve boya sırasıdır: q grafik durumunu kaydetmek için bir cm matrisi, ölçeği köşegende ve ofseti öteleme yuvalarında taşır, /StitchSrc Do dış bir nesneyi çağırmak için, ve Q durumu geri yüklemek için. q/Q çifti önemlidir: dönüştürmeyi yalıtır, böylece dikilmiş sayfa kendi koordinat sistemini sonradan eklenen hiçbir şeye sızdırmaz. Yöntem ayrıca bariz hataları da denetler, aralık dışı dizinler, kaynağa eşit bir hedef, pozitif olmayan bir ölçek (bunu 1.0 değerine kırpar) ve yükseltme yapmadan sessizce çıkar, bu yüzden girdilerinizi kontrol edin, çünkü sessiz bir no-op başarıyla aynı görünür
StitchLoadedPageSideBySide genel yöntemin ince bir kolaylık katmanıdır. Hedefin media box genişliğini okur, bunu ikiye böler ve StitchLoadedPage ile bu yarım genişliği X ofseti olarak, sabit 0.5 ölçeğiyle çağırır, kaynağı sağ yarıya yerleştirir. Bu sabit 0,5, kaynak ve hedefin genişliği paylaştığını varsayar; paylaşmıyorlarsa kaynak yarısını düzgün doldurmaz ve kendi hesaplayacağınız bir ölçekle genel StitchLoadedPage yöntemini isteyeceksiniz
Stitch, kaynak sayfaya nasıl başvurur
Görüntüleyiciler arasında çıktıya güvenmeden önce bilmeniz gereken ayrıntı budur. Klasik N-up yerleştirme, kaynak sayfanın içeriğini bir Form XObject içine sarar — ISO 32000-1 §8.10.1'in /Type /XObject, /Subtype /Form ve kendi /BBox kırpma kutusu taşımasını zorunlu kıldığı, kendine yeten çizilebilir bir nesne. StitchLoadedPage daha hafif bir yol izler: kaynak sayfa sözlüğünün kendisini doğrudan hedefin /Resources /XObject altına StitchSrc adıyla kaydeder ve Do ile çizer. Bir sayfa sözlüğü ile Form XObject, içerik modelinin yeterli ölçüde ortak yönü paylaşır — ikisi de bir içerik akışına ve bir kaynak sözlüğüne başvurur — ki pek çok görüntüleyici sonucu render eder
Kaydedilen nesne /Subtype /Form işaretleyicisi ve kendi /BBox'ı taşımadığı için, katı bir tüketici Do'yu yok sayma ya da beklediğinizden farklı kırpmaya hakkı vardır. Bu yüzden stitch çıktısını yalnızca kendi makinenizdeki değil, müşterilerinizin çalıştırdığı belirli görüntüleyicilerde doğrulayın; arşiv ya da katı doğrulayıcıdan temiz geçmesi gereken PDF'lerde sayfaları yukarı akışta tam bir Form XObject sarmalayıcıyla yerleştirin. Aynı disiplin, açılmış nesne grafiği üzerine kurduğunuz her şeye uygulanır; bu yüzden belgeleri programatik olarak değiştirdiğinizde, bir Delphi'de PDF preflight geçişi sürüm hattında kendine yer bulur
Bunların nerede işe yaradığı ve nerede yaramadığı
İki yöntem de içerik akışı aracıdır, bu yüzden zihinsel model doğrudan çizim için kullandığınızla aynıdır. Bileşenle sıfırdan sayfa oluşturduysanız, bu çağrıların arkasındaki vektör ve renk işleçleri size HotPDF canvas drawing in Delphi; fark yalnızca burada başkasının yazdığı bir akışa ekleme yapıyor olmanız, kendinize ait olana değil. Üç sınırı akılda tutun:
- Redaksiyon görsel bir maskelemedir.
RedactLoadedRectiçeriğin üstünü boyar ve onu asla silmez. Hassas olan her şey için kaynağı yeniden üretin ya da gerçek içerik kaldırma kullanın, siyah kutu güvenlik değildir - Stitch edilen sayfaları hedef görüntüleyicilerinizde doğrulayın. Kaynak sayfa,
/Subtype /Formve/BBoxtaşıyan bir §8.10.1 Form XObject'i yerine doğrudan başvurulur; bu yüzden render'i hedef görüntüleyicilerinizde teyit edin ve katı doğrulamanın gerektiği yerlerde yerleştirmeyi yukarı akışta yapın - Koordinatlar sayfanın kullanıcı uzayıdır. Sol alt köşe başlangıçtır, birimler puntodur ve sayfanın kendi media box'ı belirleyicidir. Bir şey yerleştirmeden önce kutuyu
GetLoadedPageBoxkontrol edin, çünkü yüklediğiniz sayfa sandığınız boyutta olmayabilir
Bu sınırlar göz önünde tutularak kullanıldığında ikili gerçek bir iş akışını karşılar: baskı için sayfaları yeniden düzenlemek, gizli olmayan bölgeleri maskelemek ve sonucu SaveLoadedDocument ile geri yazmak — hepsi tam bir yeniden render olmadan. Bu stitch ve maskeleme ilkellerini de içeren açılmış belge API'si, form alanı, annotation ve FDF yöntemleriyle birlikte, Delphi ve C++Builder için HotPDF Delphi Component ile gelir