CompressImages

Bildverarbeitung, Dokumenteigenschaften

Beschreibung

Legt den Standardkomprimierungsmodus fest, der auf rohe Rasterbilddaten angewendet wird, die nach diesem Aufruf dem Dokument hinzugefügt werden. Die Einstellung betrifft Bilder, deren Pixel unkomprimiert hochgeladen werden (BMP, rohe Pixelarrays); bereits komprimierte Bilder (JPEG, JPEG 2000, CCITT, JBIG2) behalten ihre vorhandene Codierung und werden unverändert gespeichert, da eine erneute Komprimierung die Datei vergrößern und die Qualität beeinträchtigen würde

Syntax

Delphi

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

ActiveX

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

DLL

int DLCompressImages(int InstanceID, int Compress);

Parameter

Compress	0 — rohe Rasterbilder unkomprimiert speichern. 1 — rohe Rasterbilder mit Flate komprimieren (Filter `/FlateDecode`).

Rückgabewerte

0	Der Parameter Compress lag außerhalb des Bereichs.
1	Die Einstellung für die Bildkomprimierung wurde aktualisiert

Anmerkungen

Die Einstellung wirkt sich nur auf Bilder aus, die nach dem Aufruf hinzugefügt werden. Standardmäßig wird komprimiert. Das Deaktivieren der Komprimierung kann gelegentlich bei der Integration mit einem nachgelagerten Renderer nützlich sein, der keine mit Flate decodierten Bildstreams unterstützt; lassen Sie die Komprimierung bei normaler Verwendung aktiviert.

Flate-Komprimierung ist verlustfrei. Für verlustbehaftete JPEG-Komprimierung eines Roh-Rasterbilds kodieren Sie die Quelle vor dem Hinzufügen als JPEG und verwenden AddImageFromFile oder AddImageFromStream — der JPEG-Bytestream wird dann direkt mit einem Filter /DCTDecode eingebettet.

Beispiel

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

Siehe auch

CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream