README 3/11/91
Image Tool

_______________________________________________________________________________
BEFORE YOU BEGIN

Please read the README.FIRST file - found at the root level of this server - 
for general information and instructions on unarchiving and uncompressing
files.

The README.BROCHURE also contains helpful descriptions of this and other
software offered on the ftp server.

_______________________________________________________________________________
IMAGE TOOL

This REDAME file is in the anonymous ftp directory for Version 1.1 of 
ImageTool for the Sun Workstation.

PLEASE NOTE: If a (?) appears below the data is in question! In other words
	     don't tell us that it is wrong because it is!

_______________________________________________________________________________
NEW FEATURES

1. Support for the full line of Sun Architectures. This includes
   the Sun-3, Sun-4, and Sun386i.
2. Support ONLY for SunOS 4.x. Please let us know if 3.x support on
   the Sun-3 is critical. ImageTool 1.1 has NOT been tested under
   SunOS 3.x. We guarantee that it will not work completely
   reliably under 3.x because of changes in the OS!
3. ImageTool 1.1 has a lot similarities to ImageTool 1.0 but is
   not fully upward compatiable.
4. Includes full NCSA HDF (Hierarchical Data Format) support. The
   HDF routines are included as part of the distribution.
5. There are no embedded parameters in the source distribution. They
   are now handled through Sun User Defaults database mechanism.
6. A number of cosmetic changes have been made. In particular,
   panel fonts are selected from the user defaults database so that
   one can now run ImageTool in a SunView Environment with
   different fonts outside of ImageTool. You still don't have
   control over the font of the frame labels because that remains a
   limitation of SunView.
7. Great care has been made to simplify the installation.  There is
   one Makefile with two targets: personal and system. Run personal
   to produce a working local version first and then run system as
   root for the system wide version once you are satisified that the
   local version works out. READ THE MAKEFILE BEFORE DOING ANYTHING!
   It will save you some grief especially on the Sun-4. The
   instructions are relatively painless. Please do not be intimidated
   by the actual details of the script.
8. Testing:
	Sun-3/160, Sun-3/110	SunOS 4.0.0 
	Sun386i/250		SunOS 4.0.1
	Sun-4/150		SunOS 4.0.3 (?)
9. Claim:
	Should work fine on the new SparcStations and the new 
	68030 based workstations without change. Let us know
	if it does or does not!

_______________________________________________________________________________
INSTALATION NOTES

File:	ImageTool1.1.src.tar.Z
Contents:

ImageTool.d		- Master Defaults Database file for ImageTool. This
			  is modified during system installation and copied
			  to the directory /usr/lib/defaults.
HDF/			- NCSA HDF (Hierarchical Data Format) directory
			  containing all the source and makefile to create
			  the libdf.a library. 
Makefile		- Makefile for installing ImageTool.
headers/		- Directory containing global .h files for ImageTool
			  1.1beta source.
imagetool.help/		- Directory containing the online ASCII help files.
src+obj/		- Directory containing the ImageTool 1.1 source.
imagetool.pal		- A 256-color initital raw palette.
samples/		- Directory of samples.


1. Put copy of  dist.tar.Z  in your current directory.
2. Space required in this directory to continue:

	2.1 Extracted files from compressed tar file
		~ 3.6 MB
	2.2 Personal installation - additional
		~ .8 MB	 	Sun-3
		~ .8 MB	 	Sun386i
		~ .8 MB 	Sun-4
	2.3 System installation - no space is used in this
	    directory unless you so designate it in the Makefile.

    PLEASE NOTE THAT TEMPORARY SPACE IS REQUIRED TO DO EITHER
    INSTALLATION. Consult the Makefile in the distribution for
    approximate sizes.

3. Execute:

	zcat dist.tar.Z | tar xvfB - 

   to extract the directory	./v1.1beta.dist
   and place it in your current directory.

4. Execute:

	cd v1.1beta.dist

   and read the documentation in the Makefile carefully.

5. For a personal installation:

	5.1 Change any required macros (only one at most) in the
	    Makefile.
	5.2 Execute:

		make personal

		. . . messages . . .
			
	     The executable, imagetool, is now ready to execute
	     in SunView IN THIS DIRECTORY! If you move out of this
	     directory you will have to change some personal defaults
	     by either editing $HOME/.defaults or executing

		defaultsedit

	     in SunView and changing them.

6. For a system installation:

	6.1 Change any required macros (only at most three) in the
	    Makefile.
	6.2 Become superuser by executing:

		su root
		password: <fill in>

	6.3 Execute:

		make system

		. . . messages . . .

	6.4 Execute in SunView:

		defaultsedit

	    and install the ImageTool master database values in
	    your personal database. The values created by the
	    personal installation will have to be replaced by the
	    master ones. This involves erasing the current values
	    and saving the defaults.

	6.5 Add the system directory where imagetool and
	    associated files were installed to your search path
	    by editing either your .login/.cshrc file or .profile
	    file.

_______________________________________________________________________________
INSTALLATION 4/30/91

There are several subdirectories under the Imagetool base directory.

	src	The source for Imagetool
	help	The help files for Imagetool
	doc	The troff form of the Imagetool manual.
	images	Some sample images.  "xx" is an animation sequence.
	pals	Some sample palettes.

There is also a sample .imagetool_defaults file.

=========================================================================

Building Imagetool

To build Imagetool, first go to the src directory.  Edit the file
"config.h" and modify its contents as directed by the comments in the
file.  There are four symbols to be concerned with.

	SUN4		if you are compiling for a Sun 4
	FPA		if your Sun 3 has a Floating Point Accellerator
	BIN_DIR		the directory for the imagetool binary
	HELP_DIR	the directory for the help files in quotes

After editing config.h, run "make".  It should build the imagetool binary.
Then, to install the binary and help files, you may need to become
superuser (or find one).  Then run "make install".

You should be able to run Imagetool with the command "imagetool &".
