xcmstest(1)

     NAME
          xcmstest - XCMS test program

     SYNOPSIS
          xcmstest [-display displayname]

           or

          xcmstest -echo [-display displayname] < cmdfile

     DESCRIPTION
          xcmstest was developed as a simple test interface for
          testing the XCMS API library during its development.

     BEFORE INVOCATION
          Insure that the Screen Color Characterization Data has been
          placed in the appropriate properties on the screen's root
          window.  To load these properties, refer to the xcmsdb
          utility provided with this release.

          In order to convert color names using a client-side color
          name database, the database file must be specified via the
          XCMSDB environment variable.

          To use the sample database provided with this release set
          XCMSDB as follows:
              % setenv XCMSDB `pwd`/Xcms.txt

     USING XCMSTEST
          Upon invocation of xcmstest, you should receive a "XCMS >"
          prompt.  At this point you can begin entering commands.

          To list the commands currently available enter "list":
                      XCMS >  list

          To receive help for a specific command enter the command
          name followed by "-help".  For example:
                      XCMS >  LookupColor -help

          The -echo option provides a more readable output, echoing
          the command from the cmdfile.  At some point in time, you
          might try using some simple test cases provided with the
          release (in the tc directory, e.g.  test1, test2,
          AllocNColor, gamutquery).  For example, to use commmand file
          test1, invoke xcmstest as follows:
                      % xcmstest -echo < tc/test1

     CAVEATS
          Color name strings passed to xcmstest commands cannot
          contain a space.  However, since spaces are ignored by the
          XCMS API library, you can pass a color name with the spaces
          eliminated.  For example:
                      XCMS >  LookupColor cornflowerblue UNDEFINED RGB


     SEE ALSO
          xcmsdb(1), Chapter 6 of Xlib - C Language X Interface.

     COPYRIGHT
          Copyright 1991, Massachusetts Institute of Technology.