Preconfigured IIPImage Server with Display Clients OpenSeaDragon, IIPZoom and IIPMooViewer. This docker was built to learn these components, and provide an easy to use server for displaying gigapixel images with no configuration.
Using this docker is extremely easy. You need to put any images you want displayed in the folder mapped to /pics, and then just pass the filename you want displayed. This filename is passed as a php argument in the web address and is relative to /pics/.
To display your image 'image1.tif', assuming that your image was stored in /pics/image1.tif you would use:
- OpenSeaDragon
- IIPZoom
- IIPMooViewer
To display images in subfolders, you would again just put the path relative to /pics/. For picture /pics/subfolder/image1.tif you would use:
- OpenSeaDragon
- IIPZoom
- IIPMooViewer
docker create \
--name=iipimageserver \
-p 80:80 \
-v <path to data>:/pics \
--restart unless-stopped \
tjw1184/iipimageserver
Container images are configured using parameters passed at runtime. These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.
| Parameter | Function |
|---|---|
-p 80 |
will map the container's port 80 to port 80 on the host |
-v /pics |
this will contain the high-resolution images you want displayed |
IIPImage is an advanced high-performance feature-rich image server system for web-based streamed viewing and zooming of ultra high-resolution images. It is designed to be fast and bandwidth-efficient with low processor and memory requirements. The system can comfortably handle gigapixel size images
OpenSeaDragon is an open-source, web-based viewer for high-resolution zoomable images, implemented in pure JavaScript, for desktop and mobile.
IIPZoom is a fast and lightweight Flash client for IIPImage which is fast and fluid with super-smooth zooming and panning.
IIPMooViewer is a high performance light-weight HTML5 Ajax-based javascript image streaming and zooming client designed for the IIPImage high resolution imaging system.