Skip to main content
Skip table of contents

PDF Compression (Version 1.0.0): Funktionen und Operationen

PDF Compression: 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: ein PDF-Dokument komprimieren


Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte: 

de.softproject.x4.adapter.PDFCompression: Hauptklasse (Standard)

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 (integer)


Statuswerte

1

Die Operation wurde erfolgreich ausgeführt.

0Die Operation wurde erfolgreich ausgeführt, jedoch ohne Ergebnis.
-1

Die Operation konnte nicht ausgeführt werden.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.