THotPDF.UseXRefStream Property

THotPDF.UseXRefStream

Išvesti PDF 1.5 /Type /XRef kryžminių nuorodų srautą (ISO 32000-1 7.5.8) vietoje tekstinės xref ... trailer sekos. Konteinerio naudingoji dalis glaudinama Flate su PNG Up predikcija (/DecodeParms /Predictor 12), /W laukų plotis pritaikomas prie faktinio poslinkių diapazono (plečiantis per 4 GiB vietoje kirpimo), o laisvųjų įrašų skylės suspaudžiamos į /Index poskyrius, todėl retki objektų numeriai nebekainuoja po atskirą eilutę

Delphi syntax:

property UseXRefStream: Boolean;

C++ syntax:

__property bool UseXRefStream;

Aprašas

Kai UseXRefStream yra true, EndDoc įrašo vieną /Type /XRef netiesioginį srauto objektą vietoj senos tekstinės xref lentelės + trailer + startxref sekos. Įrašai naudoja /W [1 4 2]: vieno baito tipo lauką, keturių baitų poslinkį (arba suspausto objekto host numerį) ir dviejų baitų generaciją (arba suspausto objekto indeksą). Visa lentelė suspaudžiama FlateDecode, dažniausiai sumažinant xref apkrovą 4-10 kartų dideliuose dokumentuose

XRef srautai yra būtina prielaida UseObjectStreams funkcijai: tik dvejetainis xref srautas gali užkoduoti tipą-2 suspaustus objektų įrašus, kurie rodo į /Type /ObjStm konteinerius. Išjungus UseXRefStream išsaugojimo metu automatiškai išjungiamas UseObjectStreams

Numatytoji vertė: false (savanoriška įjungtis - išlaiko tekstinę xref lentelę įrankiams, kurie tiesiogiai naudoja xref raktažodį, ir užtikrina didžiausią suderinamumą su PDF 1.4 arba ankstesniais skaitytuvais)

Nustatant UseXRefStream į true dokumentui, kurio Version yra mažesnė nei PDF 1.5, kūrimo metu ši nuostata tyliai ignoruojama ir vietoje jos išvedama tekstinė xref lentelė

Code Example

HPDF := THotPDF.Create( nil );
try
  HPDF.FileName := 'c:\Output.pdf';
  HPDF.Version := pdf15;          // Required for XRef streams
  HPDF.UseXRefStream := true;     // Emit /Type /XRef instead of xref table
  HPDF.UseObjectStreams := true;  // Optional: also pack objects into /Type /ObjStm
  HPDF.Compression := cmFlateDecode;
  HPDF.BeginDoc;
  HPDF.CurrentPage.TextOut( 100, 100, 0, 'Compact PDF 1.5 output' );
  HPDF.EndDoc;
finally
  HPDF.Free;
end;