Teknik Makale

Birleştirilen Sayfalar Katalogdaki PDF Sürümünü Yükseltir

2004'te taranmış bir sözleşme %PDF-1.3 ile başlar ve naif bir birleştirme, gömülü bir OpenType font ve 16 bitlik bir fotoğraf taşıyan iki broşür sayfası ekledikten sonra pdfinfo hâlâ PDF 1.3 raporlar. Doğru sürüm, eklenen revizyonun kataloguna /Version /1.6 olarak girer; ISO 32000-1 §7.5.6 buna izin verir ve HotPDF sayfa içe aktarımı bunu kopyaladığı nesnelerden yazar

Artımlı bir kaydetme neden %PDF-1.3'ü yeniden yazamaz?

Çünkü eski baytlar yeni dosyanın bir öneki olarak kalır. Bir artımlı güncelleme, son %%EOF'dan sonra yeni bir gövde, yeni bir çapraz başvuru bölümü ve yeni bir trailer ekler ve daha önceki her bayta dokunmaz. İmza doğrulayıcılar buna muhtaçtır; zira mevcut bir imzanın /ByteRange'i eski başlığı kapsar. Revizyon farkı araçları daha da ileri gider ve "özgün dosya, yeni dosyanın önekidir" ifadesini artımlı kaydetmenin tanımı sayar. Offset sıfırdaki sekiz baytı yamalamak her çapraz başvuru offset'ini geçerli tutar ama öneki yine bozar. Spesifikasyon bunu önceden görmüştür. PDF 1.4'ten beri bir yazıcı, başlığı kataloğun Version girdisiyle geçersiz kılabilir ve §7.5.6'nın 4. notu, sürümün artımlı bir güncelleme sırasında değişebilmesi için o girdinin var olduğunu söyler. Tablo 28 okuma kurallarını ekler. Değer bir name nesnesidir (1.6 sayısı değil, /1.6); yalnızca başlıktan daha yeni olduğunda uygulanır; başlık daha yeniyse veya girdi yoksa başlık kazanır. Etkin sürüm ikisinden büyüğüdür. Dosyanın yalnızca ilk satırını kontrol eden bir okuyucu, her artımlı yükseltilmiş belgeyi düşük raporlar

HotPDF ile Delphi'de birleştirilmiş bir PDF'in artımlı güncelleme düzeni: dokunulmamış 1.3 başlığı önek olarak kalırken eklenen katalog Version 1.6 taşır
başlık satırı artımlı güncelleme sırasında değişemez, bu yüzden eklenen katalog gereken Version adını taşır ve okuyucular ikisinden yenisini alır

Gereken sürümü yükselten kopyalanan nesneler

Gereken sürüm özelliklerden gelir, kaynak dosyanın başlığından değil. THPDFHeadlessDocument.AppendImportedPages, klonladığı sayfa sözlüklerini ve kaynakları gezerek kopyalanan null olmayan her girdinin gerektirdiği en yüksek sürümü kaydeder. Etiketler, özellik kontrolleriyle kesin bir PDF sürümüne kaydetmede kullanılanların aynısıdır; burada yukarı doğru çalışır, beyan edilen seviyeyi yükseltir. Her satır, içe aktarımın uyguladığı bir kontrolü ISO 32000-1'in girdinin yanına bastığı sürümle eşleştirir:

Kopyalanan içerikGerekenSpesifikasyonun söylediği yer
Saydamlık grubu, soft mask (/SMask) veya saydam ExtGState parametreleriPDF 1.4Saydamlık modeli, §11
XMP meta veri akışı (/Type /Metadata /Subtype /XML)PDF 1.4§14.3.2
JBIG2Decode ile sıkıştırılmış görsel verisiPDF 1.4§7.4.7
JPXDecode ile sıkıştırılmış görsel verisiPDF 1.5§7.4.9
16 bitlik görsel; bir görsel XObject de olsa içerik akışındaki satır içi görsel dePDF 1.5Tablo 89, §8.9.7
Null olmayan bir /PresSteps; ya da Fly, Push, Cover, Uncover veya Fade stillerinden biri olan bir /Trans; ya da /SS veya /B taşıyan bir tanesiPDF 1.5Tablo 30, Tablo 162
Sayfalarla birlikte gelen isteğe bağlı içerikPDF 1.5§8.11
/Subtype /OpenType ile /FontFile3PDF 1.6Tablo 126
Sayfa /UserUnit, kilitli katmanlar veya bir OCMD görünürlük ifadesi /VEPDF 1.6Tablo 30, §8.11

Dissolve, Wipe veya Split gibi eski geçiş stilleri PDF 1.1'den kalmadır ve hiçbir şey yükseltmez; bu yüzden içe aktarım bir geçiş sözlüğünün /S değerini okur, çıplak bir /Trans varlığı hiçbir şey kanıtlamaz. Yazma, gezintiden sonra gelir. Gereken bir sürüm var olduğunda ve hem hedefin başlık sürümünden hem de kataloğun zaten taşıdığı herhangi bir /Version'dan büyük olduğunda yeni revizyona bir /Version adı girer; aksi hâlde katalog hiçbir /Version girdisi almaz. Başlık asla düzenlenmez. §7.5.6'nın aynı paragrafı, bir güncelleme geliştirici uzantıları eklediğinde veya kaldırdığında yazıcıdan kataloğun /Extensions sözlüğünü güncellemesini ister. Sayfa içe aktarımı yalnızca sayfa düzeyindeki nesneleri kopyalar, dolayısıyla /Extensions hedefin sahip olduğu hâlde kalır

Delphi'de HotPDF sayfa içe aktarımının sürüm merdiveni: OpenType fontlar, 16 bitlik görseller ve saydamlık gereksinimi eklenen katalogda 1.3'ten 1.6'ya yükseltir
içe aktarım gezintisi kopyalanan her girdinin gerektirdiği en yüksek sürümü kaydeder ve Version adı yalnızca hem başlığı hem önceki her geçersiz kılmayı geçtiğinde yeni kataloğa düşer
uses
  SysUtils, HPDFHeadlessDocument;

procedure AppendBrochurePages(const ContractFile, BrochureFile, OutputFile: string);
var
  Target, Source: THPDFHeadlessDocument;
  Options: THPDFHeadlessPageImportOptions;
  Outcome: THPDFHeadlessPageImportResult;
begin
  Target := THPDFHeadlessDocument.Create;
  Source := THPDFHeadlessDocument.Create;
  try
    Target.LoadFromFile(ContractFile);   // başlık: %PDF-1.3
    Source.LoadFromFile(BrochureFile);   // PDF 1.7 dışa aktarım: /FontFile3 /OpenType + 16 bitlik fotoğraf

    Options := THPDFHeadlessPageImportOptions.Default;
    // Sayfa indeksleri sıfır tabanlıdır: kapağı ve teknik föyü kopyala
    Outcome := Target.AppendImportedPages(Source, [0, 2], Options);

    // Artımlı güncelleme olarak kaydedilir: eski baytlar önek olarak kalır.
    // Beklenen: yeni katalog revizyonu /Version /1.6 taşır,
    // ve dosyanın ilk satırı hâlâ %PDF-1.3 okur
    Target.SaveToFile(OutputFile);
    WriteLn(Format('%d pages added, %d annotations flattened',
      [Outcome.AddedPages, Outcome.FlattenedAnnotations]));
  finally
    Source.Free;
    Target.Free;
  end;
end;

Bu çift için OpenType font programı gereksinimi 1.6'ya çeker ve 16 bitlik fotoğraf tek başına 1.5'te dururdu. Kaynak ve hedef iki farklı yüklenmiş belge olmalıdır. Zaten imzalı veya sertifikalı bir hedef reddedilir, çünkü sayfa eklemek imzanın tanıklık ettiği şeyi değiştirir

Satır içi görseller içerik akışının içinde yaşar

Bir satır içi görsel asla bir nesne değildir. ISO 32000-1 §8.9.7 onu, doğrudan bir içerik akışına yazılan bir BI … ID … EI dizisi olarak tanımlar; /BitsPerComponent için /BPC gibi kısaltılmış anahtarlarla ve formu yalnızca 4 KB ve altındaki küçük görseller için önerir. Oradaki 16 bitlik bir derinlik, bir görsel XObject'te olduğu gibi PDF 1.5 ister; ama bir nesne gezintisi onunla hiç karşılaşmaz, çünkü o baytlar kopyalanan /Contents'in içinde seyahat eder. Bu yüzden içe aktarım her kopyalanan sayfanın içerik akışlarını ve klonladığı her Form XObject ile tiling pattern'i de çözer ve derinliği 16 olan bir BI başlığı için bir kez tarar. Düz bir metin araması yanlış ateşlerdi. Bir show-text operatörünün operandı (BI /BPC 16 ID) literalini taşıyabilir ve bir yorum satırı % BI /BPC 16 okuyabilir. ID'den sonra tek bir boşluk baytı, iki yanında da boşluk olan bir EI jetonuna dek süren ham ikili örnek veriye yer açar — ve o örnek baytlar tesadüfen BI heceleyebilir. Tarayıcı bu yüzden literal ve hexadecimal dizelerin, yorumların ve satır içi örnek verinin üzerinden atlar ve ilk gerçek 16 bitlik başlıkta durur. 8 bitlik bir satır içi görsel veya yalnızca /BPC 16 söz eden bir dize, sürümü olduğu yerde bırakır

HotPDF sayfa içe aktarımının Delphi'de kullandığı içerik akışı tarama akışı: yorumların, dizelerin ve ikili benzerlerinin üzerinden atlayarak 16 bitlik satır içi görseli bulur
satır içi görseller kopyalanan içerik akışlarının içine gizlenir; tarayıcı yorumların, dizelerin ve örnek baytların üzerinden atlayarak gerçek bir 16 bitlik başlık görünene dek ilerler

Kaynak dosyanın başlığı sürüme karar verir mi?

Hayır. Kararı seçilen sayfalar verir. Broşürün 1.7'sini birleştirmeye damgalamak, o sayfalar PDF 1.3 çizim operatörlerinin ötesinde hiçbir şey kullanmadığında sonucu olduğundan geniş gösterir. Genişletilmiş bir sürüm, dosyaları sürüme göre ayıklanan bir baskı iş akışında veya arşiv geçidinde sade bir belgeyi yanlış yola sokabilir. Anahtarları eşleştirip değerlerini yok saymak da aynı yöne hata eder. /Mask null, /PresSteps null ve /S /Dissolve taşıyan bir /Trans sözlüğü ilginç anahtarın hepsini içerir, hiçbiri daha yeni bir sürüm gerektirmez ve anahtar adlarına tepki veren bir tarayıcı hiç gerekmeden sürümü yükseltir

PDF 1.2 dosyadaki bir PDF 1.3 özelliği 1.4 olarak bildirilir

İnce durum sürüm aralığının dibinde oturur. Açık ve color-key görsel maskeleri (Tablo 89'daki /Mask) PDF 1.3 olarak etiketlenir. Böyle bir görseli bir %PDF-1.2 belgesine kopyalarsanız katı gereksinim 1.3'tür. Ama /Version PDF 1.4'te doğmuştur. 1.2'lik bir dosyaya /Version /1.3 yazmak, beyan edilen seviyenin sahip olmadığı bir mekanizma kullanır; katı bir okuyucunun ona uymak için hiçbir nedeni yoktur. HotPDF o durumda 1.4 bildirir: başlığı 1.3'ün altında olan bir belgeye giren bir görsel maskesi gereksinimi doğrudan 1.4'e, geçersiz kılmanın yasal olduğu ilk sürüme taşır. Zaten 1.3'te olan bir hedef aynı görsel için hiçbir geçersiz kılmaya ihtiyaç duymaz

Etkin sürümü geri nasıl okursunuz?

Başlık sürümünü alın, katalogdaki /Version adını bulun ve hangisi daha yeniyse onu kullanın. Tam bir ayrıştırıcı kataloglara trailer'ın /Root'u üzerinden ulaşır. Toplu işte hızlı bir kapı için bir bayt taraması çoğu zaman yeterlidir; tek bir uyarı baştan söylenmelidir: girdiyi yalnızca en yeni katalog revizyonu, herhangi bir sıkıştırılmış nesne akışının dışında düz bir nesne olarak yazıldığında bulur. Sondan doğru arayın. Artımlı olarak güncellenmiş bir dosya her revizyonda bir katalog tutabilir: önce özgünü, sonra her güncellemede tam bir yedek kopyası. Okuyucular her nesnenin en güncel kopyasını kullanır (§7.5.6), dolayısıyla dosyadaki son /Version normalde yaşayan kataloğa aittir. Boş bir sonuç, bu taramanın düz metin geçersiz kıması bulamadığı anlamına gelir; bir ayrıştırıcı bir nesne akışının içinde hâlâ bulabilir. İşlev etkin sürümü 1.6 gibi bir dize olarak döndürür ve ardından gelen kapı, temel standardı ISO 19005-1'in PDF 1.4 üzerine kurulu olduğu bir PDF/A-1 kanalını korur:

uses
  SysUtils, IOUtils;

function EffectivePdfVersion(const FileName: string): string;
const
  Key: RawByteString = '/Version';
var
  Bytes: TBytes;
  Text: RawByteString;
  P, Q: Integer;
  Declared: string;
begin
  Result := '';
  Bytes := TFile.ReadAllBytes(FileName);
  if Length(Bytes) < 8 then
    Exit;                                     // '%PDF-1.x' için fazla kısa
  SetString(Text, PAnsiChar(@Bytes[0]), Length(Bytes));
  if Copy(Text, 1, 5) <> '%PDF-' then
    Exit;
  Result := string(Copy(Text, 6, 3));        // '%PDF-1.3' -> '1.3'

  // En yeni revizyon sonda durur, o yüzden geriye doğru ara
  P := Length(Text) - Length(Key) + 1;
  while (P > 0) and (Copy(Text, P, Length(Key)) <> Key) do
    Dec(P);
  if P = 0 then
    Exit;                                     // düz metin geçersiz kıilması bulunamadı

  Q := P + Length(Key);
  while (Q <= Length(Text)) and (Text[Q] in [#0, #9, #10, #12, #13, #32]) do
    Inc(Q);
  if (Q < Length(Text)) and (Text[Q] = '/') then
  begin
    Declared := string(Copy(Text, Q + 1, 3)); // name nesnesi: /1.6
    if Declared > Result then                 // başlık daha yeniyse başlık kazanır
      Result := Declared;
  end;
end;

procedure RequirePdfA1Channel(const FileName: string);
var
  Version: string;
begin
  Version := EffectivePdfVersion(FileName);
  if Version > '1.4' then
    raise Exception.CreateFmt(
      '%s declares PDF %s; the PDF/A-1 channel takes PDF 1.4 at most',
      [ExtractFileName(FileName), Version]);
end;

Dize karşılaştırması işe yarar, çünkü yayımlanmış her PDF sürümünün tek basamaklı bir ikincil numarası vardır ve 2.0 hâlâ her 1.x değerinin üstünde sıralanır. Kapının dokunmadığına dikkat edin. Dosyayı gizlice geçirmek için /Version'ı silmez ve başlığa tek başına asla güvenmez. Yalnızca başlığa bakan bir kontrol birleştirilmiş sözleşmeyi geçirtirdi. Dosya hâlâ bir PDF 1.6 font biçimi taşıyor

Yalnızca 1.4'lük bir hatt için reddetme veya düşürme

Geçersiz kılmayı silmek yanlış tamirdir. 1.6 gerektiren nesneler hâlâ dosyadadır; sürüme duyarlı bir okuyucu 1.6 font biçimi kullanan bir 1.3 belgesi görür ve preflight araçları bu uyumsuzluğu raporlar. Gerçekten 1.4 ile sınırlı bir hattın iki sağlam seçeneği vardır. Birleştirmeyi kaydedilmeden önce reddedin, test etkin sürüm olsun; ya da önce kaynak sayfaları hedef seviyesine indirin — font ve görsel içeriği yazım aracında dönüştürün, sonra sonucu içe aktarın. Erken reddetmek daha iyi varsayılandır. Hata, iş hâlâ çalışırken dosyayı ve sürümü adlandırır; bu, bir hafta sonra kimsenin açıklayamayacağı bir doğrulama hatasından çok daha az destek maliyeti doğurur. Tek bir gereksinim içe aktarım sırasında kaldırılabilir: Options.RemovePresentationSteps := True ile kopyalanan sayfalar /PresSteps'i dışarıda bırakır, böylece alt sayfa gezinmesi gereken sürüme hiçbir şey eklemez. Kararın kaydetme anına ait olduğu yerlerde kaydetmeden önce bir sürüm ön kontrolü hiçbir bayt yazılmadan işi durdurur

2004 sözleşmesi için aranacak sayı 1.6'dır. HotPDF Delphi PDF component'ten AppendImportedPages çalıştıran aynı servis, birleştirilmiş çıktı üzerinde EffectivePdfVersion çağırsın. Yalnızca 1.4'lük bir hat böylece işi geri çevirebilirken hata hâlâ onu yükselten broşür sayfalarını adlandırır