IIPMooViewer is a high performance light-weight HTML5 Ajax-based javascript image streaming and zooming client designed for the IIPImage high resolution imaging system. It is compatible with Firefox, Chrome, Internet Explorer (Versions 6-10), Safari and Opera as well as mobile touch-based browsers for iOS and Android. Although designed for use with the IIP protocol and IIPImage, it has multi-protocol support and is additionally compatible with the Zoomify and Deepzoom protocols.
Version 2.0 of IIPMooViewer is HTML5/CSS3 based and uses the Mootools javascript framework (version 1.4+).
- Fast and light-weight
- Pan and zoom of ultra high resolution imaging
- Multi-protocol support
- Image rotation
- Mobile device support
- HTML5 Fullscreen API support
- Annotations of regions of images
- Synchronized viewer capability
The distribution contains all the necessary library files in both compressed and uncompressed formats. Modify the parameters in the index.html template example file provided.
You first must have a working version of the IIPImage server running if you want to use the IIP protocol and features. See http://iipimage.sourceforge.net for details. IIPMooViewer, however, also supports the Zoomify and Deepzoom protocols if you are unable to install the server or are working in a legacy environment.
Create a pyramidal tiled TIFF image using VIPS (http://vips.sf.net) or imagemagick. Or JPEG2000 if you have a JPEG2000 enabled IIPImage server.
Now modify the path and image names in the example HTML page provided - index.html to create a working client :-)
var iipmooviewer = new IIPMooViewer( "viewer", {
image: "/path/to/image.tif",
credit: "My Title"
});
/javascript : the necessary minified iipmooviewer and mootools javascript files
/css : iip.css and ie.css (for Internet Explorer)
/images : icons and image files
/src : uncompressed source javascript files
Minified files are created with the closer compiler (https://developers.google.com/closure/compiler/) with the following command:
java -jar /path/to/compiler.jar --js src/protocols/iip.js src/protocols/zoomify.js src/protocols/deepzoom.js src/iipmooviewer-2.0.js src/lang/help.en.js --js_output_file javascript/iipmooviewer-2.0-compressed.js --compilation_level SIMPLE_OPTIMIZATIONS
Options to the IIPMooViewer class constructor: (The only obligatory option is the image variable)
image : The full system path to the image. On Windows as on other systems this should be a UNIX style path such as "/path/to/image.tif". Note that this is an absolute system path and not the path relative to the webserver root
server : The address of the IIPImage server. [default : "/fcgi-bin/iipsrv.fcgi"]
credit : a credit, copyright or information to be shown on the image itself
render : the way in which tiles are rendered. Either `random' where the tiles are fetched and rendered randomly or 'spiral' where the tiles are rendered from the center outwards [default : "spiral"]
showNavWindow : whether to show the navigation window. [default : true]
showNavButtons : whether to show the navigation buttons on start up: true or false [default : true]
navWinSize : ratio of navigation window size to the main window. [default: 0.2]
scale : adds a scale to the image. Specify the number of pixels per mm
prefix: path prefix if image subdirectory moved (for example to a different host) [default "images/"]
enableFullscreen : allow full screen mode. If "native" will attempt to use Javascript Fullscreen API. Otherwise it will fill the viewport. "page" allows fullscreen but only in viewport fill mode. False disables. [default: "native"]
winResize : whether view is reflowed on window resize. [default: true]
viewport : object containing x, y, resolution, rotation and contrast of initial view
protocol : protocol to use with the server: iip, zoomify or deepzoom [default: "iip"]
annotations : An array of annotations containing struct with parameters x, y, w, h, title, text where x, y, w and h are the position and size of the annotation in relative [0-1] values, title is an optional title for the annotation and text is the HTML body of the annotation.
Please refer to the project site http://iipimage.sourceforge.net for further details
(c) 2007-2012 Ruven Pillay