#
# $Id: README,v 4.0 2003/04/28 14:44:13 hut66au Exp $
# 
# Readme file for imview binary distributions
#
# Hugues Talbot	16 Mar 2001

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 can also perform adequately as a general-purpose image display
application, but this is not the emphasis.

Imview is free software distributed under the GNU public licence.

Roadmap:
-------

 Documentation:
 -------------

  The PDF documentation for imview is included in this 
  distribution as a separate package. Be sure to install
  it as well (see below).

 Downloading the software:
 ------------------------

  You downloaded a binary distribution of Imview. I encourage
  you to also download the source code and compile it for yourself,
  especially if you find some problems with this software of if
  you can think of any enhancement you can make to it.

  Imview is distributed under the terms of the GNU Public License (GPL)
  which guarantees you a number of freedoms. You are welcome to
  use and share this software with friends and colleagues without
  restriction, you can look at and modify the code to your heart's
  content. You can keep your modifications for yourself but if you 
  want to distribute your modified software, you must do so under
  the same License (in particular you must make the changes to the 
  code available). Read the provided copy of the GPL for yourself.

  The source code is available from

  http://www.sourceforge.net/projects/imview

  Thank you for your interest!

  Installing the software:
  -----------------------

  Installing imview is now easier than ever! a `setup' GUI utility
  is now provided. Follow these steps:

  1) Untar the distribution in a temporary location

   % cd ~/tmp/
   % tar zxvf <distribution>
 
   or

   % gunzip -c <distribution> | tar xvf -


  2) Run the setup utility

   % ./setup

   follow the steps of the installation. Imview can be installed
   anywhere, just make sure you have the relevant permissions to
   write in the destination directory. Make sure that imview is
   then in your PATH. I.e: if you install imview in 

   /home/joe/software

   then imview will be available from /home/joe/software/bin
   Make sure that this directory is in your PATH.

   Typically imview will be installed in /usr/local. To do so
   you generally need root privileges, and you need to run setup
   as root.

   3) If you also installed the documentation, it will be available
   under <installation directory>/share/Imview/doc, i.e: in the
   above example /home/joe/software/share/Imview/doc/imview.pdf

   4) That's it. Please report any problems.
   

   Removing the software:
   ---------------------

   To remove the software, you can use the `imview.remove' script
   provided in the distribution, and answer all the questions.


mailto: hut66au@users.sourceforge.net

#
# End of $Id: README,v 4.0 2003/04/28 14:44:13 hut66au Exp $
#
