OpenJPEG Plugin

Provides OpenJPEGDecoder.

This plugin uses Java 22's new Foreign Function & Memory API ("Panama”) to call into the OpenJPEG library. It supports JP2, JP2 codestreams, JPX, and JPH (HTJ2K).

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

Once OpenJPEG 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-openjpeg

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

Step 2: Configure OpenJPEGDecoder

Assign OpenJPEGDecoder to the JPEG2000 format in your application configuration:

decoder.formats:
  jp2: OpenJPEGDecoder

Additionally, if you'd like to override any of the default settings used by OpenJPEGDecoder, copy the keys from config.yml.sample into your application configuration file and edit them there.