|
Liittää tai poistaa sivun pikkukuvan (PDF-sivun /Thumb-merkintä, ISO 32000-1 §12.3.4). PDF-katseluohjelmat (Adobe Acrobat, Foxit, selainkatselimet) näyttävät viitatun kuvan navigointipaneelissaan ilman, että ne rasteroivat sivun sisältöä itse, mikä tekee kuvapitoisten arkistojen avaamisesta huomattavasti nopeampaa
Delphi syntax:
procedure SetPageThumbnail(ImageIndex: Integer);
procedure ClearPageThumbnail;
Parameters
ImageIndex on arvo, jonka aiempi kutsu THotPDF.AddImage tai THotPDF.AddImageFromFile on palauttanut. Taustalla olevaan Image XObject -objektiin viitataan epäsuorasti määrittelyn mukaisesti, joten sama kuva voidaan piirtää myös tavalliselle sivulle ilman ristiriitoja. Välitä negatiivinen indeksi poistaaksesi olemassa olevan /Thumb-merkinnän
Kuvaus
Kukin PDF-sivu voi sisältää epäsuoran viitteen Image XObject -objektiin /Thumb-avaimessaan. Kuva on yleensä alinäytteistetty 8-bittinen DeviceGray-, DeviceRGB- tai Indexed-bittikartta (Acrobat käyttää karkeasti ottaen yhtä esikatselukuvan pistettä sivupistettä kohden), mutta HotPDF ei vahvista väriavaruutta – kutsuja valitsee mitä liittää. Metodi ClearPageThumbnail poistaa aiemmin liitetyn esikatselukuvan. SetPageThumbnail(-1) vastaa metodia ClearPageThumbnail. Dokumentin kuvaluettelon alueen ulkopuolella olevan arvon ImageIndex välittäminen aiheuttaa kuvailevan poikkeuksen
Example
PDF := THotPDF.Create(nil);
PDF.FileName := 'archive.pdf';
PDF.BeginDoc;
Idx := PDF.AddImageFromFile('preview.jpg', icJpeg);
PDF.CurrentPage.SetPageThumbnail(Idx);
PDF.EndDoc;
Availability
HotPDF v2.119.13. PDF-sanakirjan /Thumb-merkintä on PDF 1.0 -ominaisuus, eikä sitä rajoiteta PDF/A-, PDF/X- tai PDF/UA-yhteensopivuustiloissa. Jotta katseluohjelma avautuisi siten, että esikatselukuvapaneeli on näkyvissä, aseta myös THotPDF.PageMode := pmUseThumbs
Katso myös: Supported Image Formats, THPDFPage
|