Virtual slide viewer for CAVE2
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
external
src
.gitignore
CMakeLists.txt
License.md
README.md

README.md

Virtual slide viewer for CAVE2

Display high resolution DeepZoom images on CAVE2

Screenshots

Contact: Toan Nguyen (http://monash.edu/mivp)

Prerequisite

How to compile

Tested on MacOS 10.10 and OpenSuSE 12.3

cd vsviewer
mkdir build
cd build
cmake ..
make

How to run dzviewer

GO_DESKTOP_DZ [-n] [-p] [-m] [-a seconds] [-b buffersize] [-t numthreads] [-i dzi_file] [-l dzi_file_l dzi_file_r]
GO_CAVE2_DZ [-n] [-p] [-m] [-a seconds] [-b buffersize] [-t numthreads] [-i dzi_file] [-l dzi_file_l dzi_file_r]
  • -n: use Omicron (wand)
  • -p: if the image is shrunk until it fits within a single pixel (default vips depth option)
  • -m: display minimap at the top-left corner
  • -a seconds: go to next slides in every (a) seconds. To toggle slideview mode, press '.' (PERIOD) key on keyboard or X button on controller.
  • default values: buffersize = 16, numthreads = 2
  • check GO_DESKTOP_DZ_DEMO and GO_CAVE2_DZ_DEMO for examples

Usage

  • keyboard: use LEFT, RIGHT, UP, DOWN to pan; PAGE_UP/PAGE_DOWN to zoom; 'n'/'b' to go to next/previous image; '.' (PERIOD) to toggle slideview mode
  • PS3 move controller: use LEFT, RIGHT, UP, DOWN button to pan; A/B buttons to zoom; L1 button to go to next image; X to toggle slideview mode

Note: Convert to PyramidalTIFF with ImageMagick

  • convert input.tiff -compress jpeg -quality 90 -define tiff:tile-geometry=256x256 ptif:output.tiff

Note: Convert to virtual slide to DeepZoom with Vips

  • vips dzsave 3755.svs 3755 --tile-size 1024 --depth onetile
  • vips dzsave 3755.svs 3755 (in this case, we need to turn on -p option because the image is shrunk until it fits within a single pixel

Log

  • v1.1.1: add onepixel pyramid support
  • v1.1.0: async image reading
  • v1.0.0: DeepZoom input