HOW TO USE THE MONASH IMAGE LIBRARY AT HOME

                          CSE3314 Image Processing
             School of Computer Science and Software Engineering
                              Monash University

                    Document prepared by Torsten Seemann
                  Updated 21 August 2002 (bug in line 39!)

DISCLAIMER

	The downloadable "home" of the Monash Image Library is made
	available without guarantees that it will work with your system. 
	The author(s) can not solve any problems you may have!

REQUIREMENTS

	* A recent version of Linux installed eg. Redhat 6.x or higher
	* X-Windows (the graphical interface to Linux)
	* The programs "xv", "less", "zip" installed
	* About 4 megabytes of free disk space

STEP 1 : DOWNLOAD THE ARCHIVE

	Use your web browser to get it from:

	http://www.csse.monash.edu.au/software/mil/mil-i386-ddMMMyyyy.zip

        where ddMMMyyyy is the latest version date, and save it in your home
	directory (usually /home/username)

STEP 2 : CHANGE TO YOUR HOME DIRECTORY

	Type "cd" or "cd $HOME".

STEP 3 : UNPACK THE ARCHIVE

	Type "unzip mil-i386-ddMMMyyy.zip" 
   
        This should print out a long list of files and create a new "mil"
        directory in your home directory

STEP 4 : EDIT YOUR LOGIN SCRIPTS

	Using a text editor such as "vi" add the following lines to the END
	of your $HOME/.bashrc file:

		MILHOME=${HOME}/mil
		IMAGES=${MILHOME}/images/colour:.
		IMAGES=${MILHOME}/images/grey:${IMAGES}
		PATH=${MILHOME}/bin:${PATH}
                export MILHOME IMAGES PATH

	Now log out and log back in.

STEP 5 : TRY THE EXAMPLE PROGRAMS

	"cd $MILHOME/examples"
	"make"
	"ex1 lenna_512_512.img"
	"less README"