CompressImages

Traitement des images, propriétés du document

Description

Définit le mode de compression par défaut des données matricielles brutes ajoutées après cet appel. Il concerne les pixels non compressés, BMP ou tableaux bruts ; les images déjà compressées, JPEG, JPEG 2000, CCITT ou JBIG2, conservent leur encodage, car une recompression gonflerait le fichier et dégraderait la qualité

Syntaxe

Delphi

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

ActiveX

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

DLL

int DLCompressImages(int InstanceID, int Compress);

Paramètres

Compress	0 — stocker les images matricielles brutes sans compression. 1 — compresser par Flate les images matricielles brutes (filtre `/FlateDecode`)

Valeurs de retour

0	Le paramètre Compress était hors limites
1	Le paramètre de compression des images a été mis à jour

Remarques

Le réglage ne concerne que les images ajoutées après l’appel. La compression est activée par défaut. Sa désactivation peut être utile avec un moteur en aval qui ne prend pas en charge les flux d’image décodés par Flate ; en usage normal, laissez-la activée

La compression Flate est sans perte. Pour une compression JPEG avec perte d’une image matricielle brute, encodez la source en JPEG avant l’ajout et utilisez AddImageFromFile ou AddImageFromStream — le flux JPEG est alors incorporé directement avec un filtre /DCTDecode

Exemple

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

Voir aussi

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream