On this page:
The Image Delivery Service (IDS) delivers digital images that are stored in the Digital Repository Service (DRS) to web browsers. In general, images available through this service have been converted from photographs, slides, prints, and other two-dimensional media held in special collections throughout the University. IDS can secure images to the Harvard community (i.e., those with a Harvard ID number and PIN) when appropriate. The Image Delivery Service can deliver images statically or dynamically.
Standard IDS Links
IDS links have this syntax:
- Static image (production):
http://ids.lib.harvard.edu/ids/view/402143532 - Static image (qa/test):
http://idstest.lib.harvard.edu:9001/ids/view/401197103 - Dynamic image in JP2 Viewer (production):
http://ids.lib.harvard.edu/ids/view/43606969?buttons=y - Dynamic image in JP2 Viewer (qa/test):
http://idstest.lib.harvard.edu:9001/ids/view/401197693?buttons=y
IIIF Image API Support
IDS also supports links that conform to the International Image Interoperability Framework (IIIF) Image API.
IIIF is a set of community supported APIs that allow any image viewing application that supports the standard to embed digital image content from any supporting institution in their applications. The Harvard Library Page Viewer uses this API to display highly zoomable images of page turned documents from the DRS.
See Linking to images using the IIIF Image API for more information.
What is static delivery?
Static delivery allows web access to an image in the DRS, similar in functionality to putting an image on a web server. Most commonly used for JPEG and GIF images, this method can deliver any image deposited in the DRS back to an end-user. This service currently delivers many of the digital images described in the VIA catalog, but it can also serve images cataloged in HOLLIS, OASIS, or any other catalog or web site that supports URL linking.
IDS static delivery links have this format:
http://ids.lib.harvard.edu/ids/view/[DRS file ID]
http://ids.lib.harvard.edu/ids/view/29509
What is dynamic delivery?
Dynamic delivery supports delivery of many different versions of a particular image, ranging from a thumbnail to beyond a full-size screen image, back to the user from a single JPEG2000 file in the DRS. This feature can greatly diminish the number of images deposited in the DRS for the same functionality as static delivery. Dynamic delivery also gives users access to an interactive interface for exploring the image, which includes the ability to zoom, pan and rotate.
Here's an example of four versions of an image: thumbnail, small, medium and large as well as the interactive interface — all rendered dynamically from one file in the repository.
Additional dynamic delivery documentation:
- Linking to JPEG2000 Images in the DRS
- Linking to images using the IIIF Image API
- Using the JPEG2000 Image Viewer
What digital files are required?
Delivery Type | File Type Deposited in DRS | File Type Delivered to Users |
---|---|---|
Static | JPEG, GIF, TIFF | Same as deposited* |
Dynamic | JPEG2000 (JP2) | JPEG |
* IDS can deliver TIFFs "as is" (not as GIF). If the browser has a plugin that displays TIFF images (e.g. Quicktime) they will be displayed in the browser, otherwise it will prompt for an application to view them.
Captions for still images
DRS collection curators can request that captions be applied to still images stored in the DRS and delivered by the Image Delivery Service. Captions can be applied in bulk before deposit in Batch Builder tool or after deposit in DRS Web Admin tool one-at-a-time per object. See Image Captions for more information. To set image captions in Batch Builder see Adding captions in Batch Builder
Setting maximum delivery size
The default maximum size for digital images delivered by the Image Delivery Service (IDS) is 2400 pixels in the largest dimension. But curators can set a lower maximum delivery size for their images on object-by-object basis. See Image Delivery Size Restriction for more information. To set maximum delivery size in Batch Builder see Adding rights restrictions in Batch Builder