README 7/2/91
NCSA XImage

_______________________________________________________________________________
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.

_______________________________________________________________________________
XIMAGE

NCSA XImage is ...

If you successfully port NCSA X Image to a machine not currently supported, we 
would be interested in getting a copy of your patches and binaries.  Send info 
to softdev@ncsa.uiuc.edu.

This NCSA software product is public domain software.  Permission is granted to 
do whatever you like with it.  We would appreciate it if you would tell us how 
you use our software, what you think of the software, additional features you 
would like to see, etc.  Please send your comments to softdev@ncsa.uiuc.edu

Please send bug reports/fixes to:
Dave Thompson
davet@ncsa.uiuc.edu
and bugs@ncsa.uiuc.edu

_______________________________________________________________________________
GENERAL NOTES

At the time of this writing (7/2/91), this source code has been successfully 
compiled on the following platforms.
	
	Sun 3 (SunOS 4.0.3)
	Sun 4 (SunOS 4.1.1)
	DECstation 3100 (Ultrix 4.0)
	IBM RS6000 (AIX 3.1 3003)
	Silicon Graphics PI (OS 3.3.1)
	Motorola 3200 (System V/68 R3V6)
	Cray 2 (UNICOS 6.0)
	Cray YMP (UNICOS 6.0)

In most cases they have successfully been compiled using either the X.V11R4 or 
X.V11R3 X window libraries from MIT.

Should you decide to compile X Image, you will need HDF (Hierarchical Data 
Format) version 3.1 or later.  Source code is available from NCSA's anonymous 
ftp server.

Version 1.2 of XImage will read data sent over a network via the DTM 
protocol/library also available on the NCSA anonymous ftp server.

The public domain 2D HP widget set is also required to compile XImage.  You may 
get this from the NCSA's anonymous ftp server. 

Sample data files and PRE-MADE EXECUTABLES may be picked up from the server as 
well.  The pre-made executables may save you the trouble of compiling ximage, 
hdf, and the 2D HP widget set for your system.

_______________________________________________________________________________
COMPILE INSTRUCTIONS

	You will need to tell the Makefile where your X libraries and 
	headers are.  See the Makefile for instructions.
	Please EDIT the Makefile to fit your system.  Type 'make'.  


------------

NOTICE:  Version 1.0.4 (and later) obtains an install Colormap resource which
tells it how to handle colormap installation.

TWM previous to R4 patch 8 distributed with X11R4 requires that clients follow 
ONLY ICCCM rules for setting colormaps.  Previously Ximage tried to satisfy all 
window managers by following ICCCM conventions and the standard method previous 
to ICCCM which was to XInstallColormap.  The default now is for ximage to 
follow ICCCM conventions by setting a colormap attribute.

If you are using a non ICCCM window manager (such as some R3 or all previous to 
R2 or the standard wm on the IRIS IRIX3.3 or earlier) you will need to do the 
following:

Edit your .Xdefaults file in your home directory so that it contains a line 
like the following:

ximage*installCMap:     True

If you are using an ICCCM compliant window manager, you may want to have a line 
that looks like this:

ximage*installCMap:     False

Note: installCMap is set to False by default, so the above line is
not necessary.
.