PDF Compression: Funktionen und Operationen

Dieser Adapter komprimiert PDF-Dokumente, die eine bestimmte Größe überschreiten. Dokumente mit einer Größe unter 100 KB werden nur geringfügig komprimiert, hier kann die Dateigröße mit dem Adapter kaum reduziert werden.

Hinweis:

Für eine fehlerfreie Komprimierung des PDF-Dokuments muss mindestens einer der folgenden Parameter im PDF Compression Adapter gesetzt sein:

regularCompression
maximumCompression
xRefCompression
mergeResources
quantize mit den Parametern numColors und alphaThreshold

Eigenschaften (Properties)

Operation

Hier legen Sie fest, welche Operation der Adapter ausführt.

Mögliche Werte:

Compress: PDF-Dokument komprimieren

Parameter

`documentPassword`	(optional) Passwort zur Verschlüsselung des PDF-Dokuments Mögliche Werte: Zeichenkette im Format des Passworts
`regularCompression`	Das PDF wird mit der regulären Komprimierung verkleinert. Hinweis: Es ist mit einer geringen Komprimierung zu rechnen, wenn nur dieser Parameter gesetzt wird. Mögliche Werte: `true`: Das PDF wird mit der regulären Komprimierung verkleinert. `false`: Das PDF wird nicht mit der regulären Komprimierung verkleinert.
`maximumCompression`	Das PDF wird mit dem maximalen Wert komprimiert. Beste Ergebnisse werden in Kombination mit dem Parameter `regularCompression` erzielt. Hinweis: Eine Aktivierung dieses Parameters kann die Laufzeit erhöhen. Hier kommt ZLIB Compression Level 9 zur Anwendung, was bestmögliche Reduzierung der Dateigröße bietet, wobei aber die Komprimierung am langsamsten ist. Mögliche Werte: `true`: Das PDF wird mit dem maximalen Wert komprimiert. `false`: Das PDF wird nicht mit dem maximalen Wert komprimiert.
`xRefCompression`	Das PDF wird mit einer compressed xRef-Tabelle (Cross-Reference-Tabelle) gespeichert. Diese Option ist nur gültig für PDFs ab Version 1.6 oder höher. Mit PDF/A-1-Dokumenten ist diese Option nicht kompatibel. Hinweis: Eine Aktivierung dieses Parameters kann die Laufzeit erhöhen. Mit diesem Parameter lassen sich 5 bis 15 % der Dateigröße einsparen, sofern das zu komprimierende PDF-Dokument nicht bereits zuvor mit xRef Compression komprimiert wurde. Mögliche Werte: `true`: Das PDF wird mit einer compressed xRef-Tabelle gespeichert. `false`: Das PDF wird nicht mit einer compressed xRef-Tabelle gespeichert.
`mergeResources`	Führt doppelte Ressourcen (Schriften, Farbräume, Bitmap-Bilder) zusammen, um die Dateigröße zu verringern. Hinweis: Wenn das PDF-Dokument wenige Ressourcen enthält, fällt die Komprimierung gering aus. Die Anwendung dieses Parameters ist sinnvoll, wenn: Bilder doppelt vorliegen ein PDF-Dokument komprimiert werden soll, das zuvor aus mehreren PDF-Dokumenten zusammengeführt wurde Mögliche Werte: `true`: Führt doppelte Inhalte zusammen. `false`: Führt doppelte Inhalte nicht zusammen.
`quantize`	Quantisiert Bilder anhand der Parameter `numColors` und `alphaThreshold`. Daher müssen, wenn der Parameter `quantize` gesetzt ist, ebenfalls die Parameter `numColors` und `alphaThreshold` gesetzt werden. Hinweis: Der Parameter `quantize` kann in einzelnen Fällen zu einer Dateivergrößerung führen sowie die Qualität und Transparenz der im PDF vorhandenen Bilder ändern. Dieser Parameter sollte nicht gesetzt werden, wenn Bilder in hoher Auflösung im PDF erwünscht sind. Mögliche Werte: `true`: Quantisiert Bilder. `false`: Bilder werden nicht quantisiert.
`numColors`	Die Anzahl der Farben in Bildern im PDF, auf die reduziert werden soll. Die Werte müssen eine Zweierpotenz (2n) sein. Mögliche Werte: `256` (Standard) Ganze Zahl (integer)
`alphaThreshold`	Gibt an, wie die Transparenz behandelt werden soll. Werte über 128 führen zu höherer Transparenz, Werte darunter zu geringerer Transparenz. Mögliche Werte: `128` (Standard) Ganze Zahl

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`0`	Die Operation wurde erfolgreich ausgeführt, jedoch ohne Ergebnis.
`-1`	Die Operation konnte nicht ausgeführt werden.