packages icon
README for xacte

Description:
xacte, the X answer to color table editors, formerly xact, is a general
purpose GUI interface color table editor for use with Unix/X11 systems.
See the xacte man page for operating instructions.

Files:
  README	This file
  Imakefile	The master Imake file
  xacte.man	The xacte man page
  xacte.c	C source code for xacte
  xfileio.c	C source code for x colortable file functions
  xfileio.h	function prototypes for xfileio.c
  xact2idraw	a perl script for changing xacte "X11" colortable files
		into X resource lines so that the Interviews program idraw
		can use xacte color tables.  You will probably need to
		modify the first line of this file to point to your
		perl interpreter.

Notes:		new colortable file types may be added to xact.c in the
		file_read_fn() and file_write_fn() functions.
		CFM and Zeb file types are internal NCAR formats.

To build xacte under X11, cd to the xact directory and type:

        xmkmf -a
        make >& makexacte.log

This will build a Makefile in the directory and all subdirectories, and then
build the software.  If the build is successful, you should be able to
install it using the following commands:

        make install >& install.log
        make install.man >& man.log

The most common problem people have with xacte is not being able to
allocate enough colors.  If you get a message like:

	X Error of failed request:  BadAccess
		(attempt to access private resource denied)
	Major opcode of failed request:  89 (X_StoreColors)
	Serial number of failed request:  762
	Current serial number in output stream:  1014

it probably means that you are running some other program such as
Netscape and it has grabbed all of the available colors.  The solution
is to exit the program that is hogging the colors while you run xacte.

	The following message will show up:
	Xacte exiting, must be run on an 8 bit display, sorry

if you are running an X windows system with more than 8 bits per pixel.
Currently, xacte only runs on systems that use an 8 bit colortable
If you are running in a true-color mode, xact will fail.  This is a
more common problem now (1998) than when the program was originally
written, I hope to fix this some day.  Those running Linux should
be able to modify the /etc/X11/XF86Config file (in RedHat) for an
8 bit mode.

Xacte has been tested on the following platforms:

X11R5:
        Sun 4c and 4m running SunOS 4.1.3 and Solaris 2.x
        HP 715/33 running HP-UX A.09.01
        SGI Indy running Irix 5.1.0.1

X11R6:
        Sun 4c and 4m running SunOS 4.1.3 and Solaris 2.x
	Linux 1.1.59 (Slakware Release)
	Linux 2.0.0 (Debian Release)

X11R6.1:
        Sun 4c and 4m running Solaris 2.4 and Solaris 2.5

XFree86:
	RedHat Linux 5.0, 5.1, 5.2

Author's name:

        G. Forrest Cook NCAR/ATD/RDP
        Email: cook@atd.ucar.edu

Date:   Wednesday, December 30, 1998