Page History

...

Introduction

The Large Image Solution Pack module supports ingesting and viewing TIF/TIFF files, which by nature tend to be extremely large in both filesize and resolution. The module supports creation of derivatives for use when a smaller filesize is necessaryloads all required Fedora objects and creates an empty collection object to accept TIFFs and JPEG2000s (JP2) and create derivatives, and also supports the installation of image viewers that can accommodate the larger resolution.

...

Requirements

This module requires the following modules/libraries:

• Islandora
• Tuque
• ImageMagick is  is required to create image derivatives
• 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

...

.

...

Downloads

Release Notes and Downloads

Configuration

...

• 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.

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

Image Added

Image RemovedSelect configuration options and viewer in Administration > Islandora > Solution pack configuration > Large Image Collection (admin/islandora/solution_pack_config/large_image).

To use Kakadu, make sure that kdu_compress and kdu_expand are avaliable  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. Make sure that the required dynamic libriraries 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 it's that the libraries are missing. You can also use a symbolic link from /usr/local/lib to include these libraries, remember . Remember to restart the terminal so your changes take affect. Also, make sure the php settings allow for enough memory and upload size: upload_max_filesize, post_max_size and  and memory_limit.

...

Image Added

Documentation

Further documentation for this module is available at our wiki

Troubleshooting/Issues

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

• Islandora Group
• Islandora Dev Group

Maintainers/Sponsors

Current maintainers:

• Alan Stanley

Development

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.

...

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