CompressImages

Image handling, Document properties

Popis

Nastaví výchozí režim komprese aplikovaný na surová raster obrazová data přidaná do dokumentu po tomto volání. Nastavení ovlivní obrázky, jejichž pixely se nahrávají nekomprimované (BMP, surová pixelová pole); obrázky už komprimované (JPEG, JPEG 2000, CCITT, JBIG2) si ponechají stávající kódování a uloží se tak, jak jsou, protože překomprimování by soubor nafouklo a zhoršilo kvalitu

Syntaxe

Delphi

Function TPDFlib.CompressImages(Compress: Integer): Integer;

ActiveX

Function PDFlib::CompressImages(Compress As Long) As Long

DLL

int DLCompressImages(int InstanceID, int Compress);

Parametry

Compress	0 — store raw raster images uncompressed. 1 — flate-compress raw raster images (`/FlateDecode` filter).

Return values

0	Parametr Compress byl mimo rozsah
1	Nastavení komprese obrázků se aktualizovalo

Poznámky

Nastavení ovlivní jen obrázky přidané po volání. Defaultem je komprimovat. Vypnutí komprese se občas hodí při integraci s následným rendererem nepodporujícím obrazové proudy flate-decode; při běžném použití nechte kompresi zapnutou

Flate compression is loss-less. For lossy JPEG compression of a raw raster image, encode the source to JPEG before adding it and use AddImageFromFile or AddImageFromStream — the JPEG byte stream is then embedded directly with a /DCTDecode filter.

Příklad

// Compress raw bitmaps but leave the pre-encoded JPEG as-is
PDF.CompressImages(1);
PDF.AddImageFromFile('logo.bmp');        // BMP -> flate compressed
PDF.AddImageFromFile('photo.jpg');       // JPEG bytes embedded directly (DCT)
PDF.AddImageFromFile('chart.png');       // PNG decoded -> flate compressed

Viz také

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream