## Introduction

> Imview is an image viewing package intended for image analysis, i.e: getting numbers (measurements) out of images. It is designed to interface easily to image analysis packages such as Khoros or Z-IMAGE (http://www.cmis.csiro.au/IAP/zimage.htm), to perform as an external viewer.

> It has facilities for histogram-based segmentation, comparing images before and after a series of filtering, etc. It supports many different image format and pixel types (integer and floating point, 1 to 64 bits).

> It can also perform more than adequately as a general-purpose image display application, but this is not the emphasis.

> Imview is free software distributed under the GNU public licence.

## Version 1.1.x:

Imview version 1.1.x is the currently unstable version based on FLTK 1.1.x

## Roadmap

> IMVIEW consists of a main executable and a few support files. Among the support files there are:

#### .lut files:

these are simple Colour Look-Up Table text files that associate a grey-level index to an RGB colour (false colours).

#### .html files:

these are the online documentation (very slim at this stage)

#### .jpg file:

this is the splash screen. Replace it or delete if you don't like it! Let me know if you make a better one.

> The main executable (imview) is a semi-static executable linked against a number of imaging libraries (JPEG, PNG, TIFF, ImageMagick) and the GUI toolkit (FLTK).

## Installer:

> Imview is provided both in source and binary form. All binary formats come with an installer. If you downloaded the RPM then use the rpm installer to make use of it, otherwise Under Unix: untar the file and type ./setup Under Windows: simply execute the file.

> #### NOTE:

> under windows 9x (95, 98 and me) you must make sure that TCP/IP is installed. If you have an internet connection you will be fine. TCP/IP is always present with Unix, NT, Win2k and WinXP.

## Documentation:

> Imview should be very simple to use, but full documentation is available in HTML, PS or PDF format, see the web site

> http://www.cmis.csiro.au/Hugues.Talbot/imview

> or

> http://imview.sourceforge.net/

## To compile imview:

> See the `INSTALL` text file. Essentially you will need the FLTK library (http://www.fltk.org), and supporting imaging libraries if they are not present on your system.

> On Unix imview uses the POSIX thread library, TCP/IP sockets and the SYSV IPC if present. Under windows an implementation of POSIX threads is provided (SYSV IPC is not used, sockets are used instead).

## The directory structure:

    imview.                     The main source repository
          |-- check             For regression testing (an interesting concept for GUIs)
          |-- client            Network client code (to remote-control imview)
          |-- distrib           To make distributions
          |   |-- binaries      Generic binary distributions
          |   |-- redhat        Specific to the RedHat RPM system
          |   |   |-- BUILD
          |   |   |-- CVS
          |   |   |-- RPMS
          |   |   |-- SOURCES
          |   |   |-- SPECS
          |   |   `-- SRPMS
          |   |
          |   `-- windows       Uses the Inno Setup installer for Windows
          |
          |-- doc               Documentation (online one only, full documentation is separate)
          |-- export            Used for making snapshots
          |-- fluid             Interface files (FLUID is the fast light user interface designer)
          |-- io                I/O library (all these different image formats)
          |-- obj               Compilation subdirectory
          |   `-- NT-msvc++     MSVC++ project files
          |       `-- fluid
          |-- server            Imview server (for remote control)
          |-- stl               Missing bits of the STL for egcs/gcc-2.95.x
          |   `-- sstream
          `-- support           Support files (LUT, etc).