PDFBox Plugin

Provides PDFBoxDecoder for decoding and rasterizing PDFs using Apache PDFBox. This is a pure-Java library that is bundled into the plugin and has no other dependencies.

The size of the base raster image, corresponding to a scale of 1, is configurable using the decoder.PDFBoxDecoder.dpi configuration option. When a scale of ≤ 50% or ≥ 200% is requested, a fraction or multiple of this is used, respectively, in order to improve efficiency at small scales, and detail at large scales.

This decoder supports a meta-identifier-encoded page number when requesting a particular page of a PDF. For example, to request page 2 using the StandardMetaIdentifierTransformer with default configuration:

http://example.org/iiif/3/document.pdf;2/full/max/0/default.jpg

When a page number is not present, the first page is returned.

Installation

Step 1: Install the plugin

Use the plugin installer:

bin/install_plugin.sh galia-plugin-pdfbox

Alternatively, download the plugin directly and extract it into Galia's plugins directory.

Step 2: Configure the plugin

Copy the keys in config.yml.sample into your main application configuration and fill them in.