Page History

...

The Large Image Solution Pack loads all required Fedora objects and creates an empty collection object to accept TIFFs and JPEG2000s (JP2) and create derivatives, and also adds the ability to create Large Image collections, which are capable of displaying high resolution TIFFs and JPEG 2000s (JP2). This module also creates derivatives and supports the installation of image viewers that can accommodate the larger resolution.

Requirements

This module requires the following modules/libraries:

• Islandora
• Tuque
• ImageMagick is required to create TN and JPG image derivatives

This module requires one of the following to create JP2 derivatives from TIFFs, or to create derivatives of JP2s:

• Kakadu (bundled with Djatoka)

To successfully create derivative data streams, ImageMagick (for TN & JPG) and Kakadu (for JP2) need to be installed on the server.

Configuration

• ImageMagick with JPEG 2000 support

Configuration

Creating image derivatives

To create image derivatives, configure the image processing Configure the image- toolkit to use ImageMagick rather than GD the GD2 image manipulation toolkit in Administration > Configuration > Media > Image Toolkit (admin/config/media/image-toolkit). If GD GD2 is selected, TN and JPG datastreams will not be generated.

Derivative Options

Configure derivative options Select configuration options and viewer in Administration > Islandora > Solution Pack configuration > Large Image Collection Images (admin/islandora/solution_pack_config/large_image).

• Create Lossless Derivatives: Enable this option to use reversible lossless compression when creating JP2 derivatives. When a JP2 original is uploaded, a second "use" copy is created for the JP2 datastream.
• Use Kakadu for Image Compression: The Kakadu software suite can be installed on your server to take advantage of its much faster kdu_compress program.  Users often use the copy of kdu_compress that comes bundled with Djatoka (see below), but you can also go to the official website at http://www.kakadusoftware.com/ for download and installation instructions.
  • To use Kakadu, make sure

...

• • that kdu_compress

...

• • is available to the Apache user. Often users will create symbolic links

...

• • from /usr/local/bin/kdu_compress

...

• • to their installation of Kakadu that comes bundled

...

• • with Adore-Djatoka. If the executable resides elsewhere on the server and no soft link has been created, be sure to provide the full path to the executable on the configuration page. Make sure that the required dynamic libraries that come with Kakadu are accessible

...

• • to kdu_compress

...

• • and kdu_expand. If they are not present, attempting to run either command from the terminal will inform you that the libraries are missing. You can also use a symbolic link

...

• • from /usr/local/lib

...

• • to include these libraries. Remember to restart the terminal so your changes take

...

• • effect. Also, make sure the php settings allow for enough memory and upload size:

...

• • upload_max_filesize,

...

• • post_max_size

...

• • and memory_limit.

Image ModifiedViewer Options

Configure viewer options in Administration > Islandora > Solution Pack configuration > Large Images (admin/islandora/solution_pack_config/large_image).

• If no viewer is selected, Large Image objects will display as a JPG preview on the View tab.
• To display a large image with zoom and pan options, follow the instructions to install the OpenSeadragon viewer. If it is installed, OpenSeadragon can be selected and configured from the Large Image configuration page.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

...

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3

Additional Usage

The Large Image Solution Pack module's configuration page can be found at http://path.to.your.site/admin/islandora/solution_pack_config/large_image, and contains the following settings:

• Lossless Derivative Creation?: Enabling this will force the Large Image Solution Pack to use reversible lossless compression when creating JP2 derivatives.  When a JP2 original is uploaded, a second "use" copy is created for the JP2 datastream.
• Use Kakadu for Image Compression?: The Kakadu software suite can be installed on your server to take advantage of its much faster kdu_compress program.  Users often use the copy of kdu_compress that comes bundled with Djatoka (see below), but you can also check out the official website at http://www.kakadusoftware.com/ for download and installation instructions.

Viewers

If no viewers are installed, the Large Image Solution Pack module will use its standard viewer to display images. For better results, the Open Seadragon library can be installed; check that page for further instructions. If it is installed, it can be selected here.

Content Models, Prescribed Datastreams and Forms

...

An image ingested using the Large Image Solution Pack's content model using ImageMagick will have the following datastreams:

The Large Image Solution Pack comes with the Large image MODS form.

...