viewer -- display a stack of images
 ===================================

 Displays a stack of images in three orthogonal views. In addition to the
 standard xy view of each image in the stack, slices through the xz and yz
 direction are shown. Each view over two axes is updated by setting the value of
 the third axis with a slider.

 Build the program by running 'configure' followed by 'make'. See the INSTALL
 file for information on how to use a configure script. If there is no configure
 script, see further below how to generate one. 

 Depends on libjwsc, libjwsc++, OpenGL, GLUT, and QT3.

 Documentation can be generated from the source code with Doxygen. 

 Start the program from a terminal by calling 'viewer'. There are currently no
 program options. Use the menu options to load images.

 Comments welcome --> Joseph Schlecht <schlecht@uni-heidelberg.de>


 Issues
 ======

 The program assumes all images in a stack have the same size (resolution). If
 this isn't the case, an assertion will fail and the program will abort. Better
 error handling is needed to handle this case.


 Building from SVN
 =================

 To build the sources from svn checkout, you need to do two things: (1) checkout
 the m4 macros and (2) build the configure script with autotools.

 1. Checking out the m4 macros

    The autotools used to build the configure script need a set of macros
    written in the m4 language and expect them to be installed in a directory
    'libjwsm4' at the same level as this program. The macros are shared by other
    programs and, if you haven't already done so, you will need to check them
    out.

    Change to the directory containing this program and execute
    
        svn co ${SVN_ACCESS}${SVN_REPOSITORY}/src/libjwsm4/trunk libjwsm4

    where SVN_ACCESS is probably either 'svn+ssh://host' or 'file:///' and
    SVN_REPOSITORY is the path to the svn repository.

    Then a directory listing would look like this

        viewer
        libjwsm4
        ...

 2. Build the configure script using autotools

    The configure script is an sh shell script that can run on just about any
    machine. It checks for the availability of other packages that the
    library depends on. Those checks are primarily constructed using the m4
    macro language, which is expanded into sh.

    To build the configure script, you need the autotools programs. If
    installed, the following set of commands will generate the configure
    script

        aclocal -I ../libjwsm4 ; autoheader ; automake -a ; autoconf

    Use the generated configure script to build the library.