Options for embedding images
IIIF Image API
The images from our archive are available in different sizes and formats.
To download a different sized image, first find its address (URL) by right-clicking on a smaller-sized image and selecting 'view image' (FireFox), 'Open Image in New Tab' (Chrome) or 'Show Picture' (IE). This will take you to a page that displays a thumbnail version of the image, with its address in the browser navigation bar.
The address will look something similar to the following:
Region:
- full: The complete image is returned, without any cropping.
- x,y,w,h: The region of the full image to be returned is defined in terms of absolute pixel values. The value of x represents the number of pixels from the 0 position on the horizontal axis. The value of y represents the number of pixels from the 0 position on the vertical axis. Thus the x,y position 0,0 is the upper left-most pixel of the image. w represents the width of the region and h represents the height of the region in pixels.
- pct:x,y,w,h: The region to be returned is specified as a sequence of percentages of the full image’s dimensions, as reported in the Image Information document. Thus, x represents the number of pixels from the 0 position on the horizontal axis, calculated as a percentage of the reported width. w represents the width of the region, also calculated as a percentage of the reported width. The same applies to y and h respectively. These may be floating point numbers.
More information: http://iiif.io/api/image/2.0/#region
Size:
- full: The extracted region is not scaled, and is returned at its full size.
- w,: The extracted region should be scaled so that its width is exactly equal to w, and the height will be a calculated value that maintains the aspect ratio of the extracted region.
- ,h: The extracted region should be scaled so that its height is exactly equal to h, and the width will be a calculated value that maintains the aspect ratio of the extracted region.
- pct:n: The width and height of the returned image is scaled to n% of the width and height of the extracted region. The aspect ratio of the returned image is the same as that of the extracted region.
- w,h: The width and height of the returned image are exactly w and h. The aspect ratio of the returned image may be different than the extracted region, resulting in a distorted image.
-
!w,h: The image content is scaled for the best fit such that the resulting width and height are less than or equal to the requested width and height. The exact scaling may be determined by the service provider, based on characteristics including image quality and system performance. The dimensions of the returned image content are calculated to maintain the aspect ratio of the extracted region.
More information: http://iiif.io/api/image/2.0/#size
Rotation:
- n: The degrees of clockwise rotation from 0, 90, 180 , 270 and 360 .
- !n: The image should be mirrored and then rotated as above.
More information: http://iiif.io/api/image/2.0/#rotation
Example:
The maximum size of an image that can be retrieved is currently fixed at 1200 pixels at its largest size. If you require a higher resolution version for any purpose, please contact us.
Our site uses open-source software called IIPImage, which supports IIIF (The International Image Interoperability Framework) image request protocol. For full details see the http://iiif.io/api/image/2.0/.
IIIF Presentation API
Qatar Digital Library also supports the IIIF presentation API.
To view the manifest describing an archive navigate to the archive.
Example:
http://www.qdl.qa/en/archive/81055/vdc_100023807156.0x000001
Then replace 'archive' by 'iiif' and add '/manifest' at the end.
Example:
http://www.qdl.qa/en/iiif/81055/vdc_100023807156.0x000001/manifest
You can use this URL to open the archive in different viewers (Mirador, Universal Viewer...).
More information on IIIF: http://iiif.io