This directory contains source code for NCSA X Image Version 1.1. At the time of this writing (10/9/90), this source code has been successfully compiled on the following platforms. Sun 3 (SunOS 4.0.3) Sun 4 (SunOS 4.0.3) DECstation 3100 (Ultrix 4.0) IBM RS6000 (AIX 3.1) Silicon Graphics PI (OS 3.2) Motorola 3200 (System V/68 R3V6) Cray 2 (UNICOS 5.0) Cray XMP48 (UNICOS 5.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 (128.174.20.50). The public domain 2D HP widget set is also required to compile XImage. You may get this from the NCSA's anonymous ftp server. 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. Should you feel compelled to make a contribution for the use of this software, please send it in the form of comments as to what you like or don't like about the software, how you use it, how it helps your work, etc. to softdev@ncsa.uiuc.edu. Please send bug reports/fixes to: Dave Thompson davet@ncsa.uiuc.edu or bugs@ncsa.uiuc.edu -------- The latest version of all NCSA software is kept on the anonymous ftp server ftp.ncsa.uiuc.edu (128.174.20.50). If you don't have access to the anonymous ftp server, you can obtain a copies through the NCSA Technical Resources Catalog. NCSA software and manuals are available for purchase. To obtain a copy of the catalog, contact: NCSA Documentation Orders 152 Computing Applications Building 605 East Springfield Avenue Champaign, IL 61820 (217) 244-0072 -------- Sample data files and PRE-MADE EXECUTABLES may be picked up from ftp.ncsa.uiuc.edu (128.174.20.50) 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. 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. The Current version of twm distributed with X11R4 requires that clients follow ONLY ICCCM rules for setting colormaps. Previously Ximage tried to satisfy everyone 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) 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. -------- Version 1.0.4 has been modified to compile with X11R4. If compiling with X11R4 you will need to compile with -DXAW_BC for Athena widget backward compatibility. Also, XImage source assumes that your system was installed with backward compatibility swithc in the X11R4 installation make. More specifically, all the Athena widget header files will be accessable at the top level X11 directory (example X11/List.h).