XCMSTEST(1)                 X Version 11(Release 5)                 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





10/89                                                                    Page 1

XCMSTEST(1)                 X Version 11(Release 5)                 XCMSTEST(1)


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

COPYRIGHT
      Copyright 1991, Massachusetts Institute of Technology.

















































Page 2                                                                    10/89