Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Remove troubleshooting, maintainer and development info

...

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 necessary, 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:

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

  • Kakadu (bundled with Djatoka)

...

Configuration

Creating image derivatives

To

...

create

...

Downloads

Release Notes and Downloads

Configuration

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

ConfigurationImage Added

Derivative Options

Configure derivative options in Administration > Islandora > Solution Pack configuration > Large Images (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:).

  • Create Lossless Derivatives: Enable this option Lossless Derivative Creation?: Enabling this will force the Large Image Solution Pack to use reversible lossless compression when creating JP2 derivatives.  When 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 go to the official website at http://www.kakadusoftware.com/ for download and installation instructions.

Configure the image-tool kit 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.

...

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

...

Large Image derivative and viewer configuration optionsImage AddedViewer Options

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

Image RemovedViewers

...

  • . If it is installed,

...

  • OpenSeadragon can be selected

...

  • and configured from the Large Image configuration page.

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:

RELS-EXT

Default Fedora relationship metadata

MODS

MODS record filled out during ingest

DC

Dublin Core record

OBJ

Original TIFF or JP2 file uploaded

JP2JPEG 2000 derivative created by ImageMagick or Kakadu
JPGMedium-sized JPEG created by ImageMagick and used in the standard image viewer
TNThumbnail icon created from the image during the ingest process

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

Note
To successfully create derivative datastreams (TN & JPG), ImageMagick needs to be installed on the server. To create JP2 datastreams, Kakadu is the preferred solution, but ImageMagick can be used if it has been built with JPEG2000 support.