Teknik Makale

Delphi İçin HotPDF ile PDF Maskeleme ve N-up Yerleştirme

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

HotPDF: Yüklü bir sayfaya operatör eklemek üç yardımcıdan geçer: sayfa Contents akışını bulmaktan, onu çözümlemeye veya oluşturmaya ve en son ham baytları eklemeye; boyayıcı model bu baytların özgün düzenin çizdiği her şeyin üzerine boyanacağını garanti eder
NewIndirectStream, ResolveLoadedStream ve AppendLoadedStream taze operatörleri var olan bir /Contents akışının sonuna ekler; böylece çizdikleri her şey, özgün sayfa düzeninden tek bir bayt yeniden yazmadan onun üzerine düşer

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

HotPDF: Boyayla örtülen hesap numarası sansürü atlatır: görüntüleyici hesap satırının üzerinde sağlam koyu bir şerit gösterirken içerik akışı hâlâ ACCT dizgesini listeler ve herhangi bir metin ayıklayıcı onu değişmeden geri yazdırır
r g b rg, re ve f operatörleri yalnızca üstüne piksel ekler — özgün metin nesnesi nesne grafiğinde canlı kalır; böylece kopyala-çıkar geçişi siyah çubuğun sakladığı her karakteri geri kazanır

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

HotPDF: Birleştirme, hedef sayfaya q, ölçek ve ofset taşıyan bir cm matrisi, bir StitchSrc Do çağrısı ve Q ekler; kaynak sözlüğü ise kaynak sayfa sözlüğünün kendisini Form alt türü olmadan ve BBox olmadan alır
q/Q çifti, ardından /StitchSrc Do gelen bir cm dönüşümünü kuşatır; ama kayıtlı nesnede /Subtype /Form ve /BBox bulunmadığı için birleştirilmiş çıktı, müşterilerinizin çalıştırdığı her görüntüleyicide görsel doğrulama ister

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. RedactLoadedRect iç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 /Form ve /BBox taşı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 GetLoadedPageBox kontrol 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