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 supports the installation of image viewers that can accommodate the larger resolution.
To successfully create derivative data streams ImageMagick (TN & JPG) and Kakadu (JP2) need to be installed on the server. |
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:
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.
Select configuration options and viewer in Administration > Islandora > Large Image Collection (admin/islandora/solution_pack_config/large_image).
To use Kakadu, make sure that kdu_compress
and kdu_expand
are avaliable 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 that come with Kakadu are excessible to kdu_compress
and kdu_expand
. If they are not present, attempting to run either command from the terminal will inform you it's 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 affect. Also, make sure the php settings allow for enough memory and upload size: upload_max_filesize, post_max_size and memory_limit.
If no viewers are installed, the Large Image Solution Pack module will use its standard viewer to display images. For better results, the OpenSeadragon 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 following objects in http://path.to.your.site/admin/islandora/solution_pack_config/solution_packs:
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 file uploaded |
JP2 | JPEG 2000 derivative created by ImageMagick or Kakadu |
JPG | Medium-sized JPEG created by ImageMagick and used in the standard image viewer |
TN | Thumbnail icon created from the image during the ingest process |
The Large Image Solution Pack comes with the Large image MODS form.