LibTIFF Plugin

Provides LibTIFFDecoder for reading TIFF images.

This plugin uses Java 22's new Foreign Function & Memory API ("Panama") to call into the libtiff library. It supports all standard TIFF compressions, pyramidal and multi-page images, BigTIFF, and efficient tile and strip reading. It can read from both files and streams. It also supports automatic orientation of images with no performance penalty.

LibTIFF is not included with this plugin and must be provided separately. Most OS package managers should provide it. The minimum required version is 4.6. Newer versions in the 4.x series should work as well, but may not have been tested. If you encounter any problems, please contact us.

Once LibTIFF has been installed, its containing directory must be present on the Java library path. You can either change your library path to include it (by adding the -Djava.library.path VM argument to your config/jvm.options file), or move the library files to one of the directories on that path. Galia logs the Java library path at startup.

Installation

Step 1: Install the plugin

Use the plugin installer:

bin/install_plugin.sh galia-plugin-libtiff

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

Step 2: Enable LibTIFFDecoder

LibTIFFDecoder must be assigned to handle the TIFF format in the application configuration:

decoder.formats:
  tif: LibTIFFDecoder

Without this, the application won't know whether to use it or the built-in TIFF decoder, and will return an error.