CompressImages

Bildhantering, Dokumentegenskaper

Beskrivning

Sätter standardkomprimeringsläget som tillämpas på rå rasterbilddata som läggs till dokumentet efter det här anropet. Inställningen påverkar bilder vars pixlar laddas upp okomprimerade (BMP, råa pixelarrayer); bilder som redan är komprimerade (JPEG, JPEG 2000, CCITT, JBIG2) behåller sin befintliga kodning och lagras som de är, eftersom okomprimering av dem skulle blåsa upp filen och försämra kvaliteten

Syntax

Delphi

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

ActiveX

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

DLL

int DLCompressImages(int InstanceID, int Compress);

Parametrar

Compress	0 — lagra råa rasterbilder okomprimerade 1 — flate-komprimera råa rasterbilder (`/FlateDecode`-filter)

Returvärden

0	Parametern Compress låg utanför intervallet
1	Bildkomprimeringsinställningen uppdaterades

Anmärkningar

Inställningen påverkar bara bilder som läggs till efter anropet. Standard är att komprimera. Att stänga av komprimering är ibland användbart vid integration med en nedströmsrenderare som inte stödjer flate-avkodade bildströmmar; vid normal användning, lämna komprimering aktiverad

Flate-komprimering är förlustfri. För förlustbringande JPEG-komprimering av en rå rasterbild, koda källan till JPEG innan den läggs till och använd AddImageFromFile eller AddImageFromStream — JPEG-byteströmmen bäddas då in direkt med ett /DCTDecode-filter

Exempel

// 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

Se även

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream