Apache™ FOP: PDF Images Plug-In¶
The fop-pdf-images plug-in extends FOP in order to add support for using PDF images in fo:external-graphic elements when generating PDF files. This means one can write something like:
Reduce file size¶
If you input many pdfs together the output pdf has duplicate fonts. Set this flag to merge fonts in fop.xconf:
<renderer mime="application/pdf"> <merge-fonts>true</merge-fonts> </renderer>
If you use many of the same pdf's and they have a large content stream, this flag can improve performance. The disadvantage will be it can cause higher memory use inside your printer. Set this flag in fop.xconf:
<renderer mime="application/pdf"> <form-xobject>true</form-xobject> </renderer>
Known issues with Postscript output¶
- If fonts are not embedded in source PDF:
- If OTF font type is needed text may be missing if Adobe Reader fonts are not found
- Text may be rendered wrong or poorly if wrong font is selected as replacement
- Transparency, layers and opacity may not render correctly
- Gradients in text may be different from the source PDF
If using the binary package, the four jar files should be placed in the lib directory of your FOP installation.
Binary distributions include "-bin" in their names, and can be downloaded from a FOP-PDF-Images Distribution mirror.
Here are the links to each package’s signature and checksum files. Signatures can be verified by using our KEYS file.
- Download a released version from a FOP-PDF-Images Distribution mirror. Source distributions include "-src" in their names.
The fop-pdf-images plug-in was donated by Jeremias Märki to the XMLGraphics project in 2012. Older releases can be obtained from his plug-in page.
History of Changes¶
- FOP-2802: Java 10 PDF/SVG to Image box not shown
- FOP-2812: Update PDFBox to 2.0.11
- FOP-2836: Update PDFBox to 2.0.13
- FOP-2840: Image mask in PDF not rendered to PS
- FOP-2841: PDF to PDF with merge-fonts checkbox misaligned
- FOP-2856: Support compile on Java 12
- FOP-2873: Update to PDFBox 2.0.16
- FOP-2879: Add caching to avoid parsing content stream
- FOP-2882: Allow PDFFormXObject to improve performance
- PDF to PDF deduplicate more types of streams
- PDF to PS allow fop fonts as fallback
- Move to PDFBox 2
- Deduplicate PDF streams
- PDF to PS deduplication of images
- Remove xobj type=form
- Merge fonts (off by default)
- Support PDF shading to PS
- Merging of Tagged (Accessible) PDF