XCMSTEST(1)					      XCMSTEST(1)


NNAAMMEE
       xcmstest - XCMS test program

SSYYNNOOPPSSIISS
       xxccmmsstteesstt [-display displayname]

	or

       xxccmmsstteesstt -echo [-display displayname] < cmdfile

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

BBEEFFOORREE IINNVVOOCCAATTIIOONN
       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

UUSSIINNGG XXCCMMSSTTEESSTT
       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, AllocN-
       Color, gamutquery).  For example,  to  use  commmand  file
       test1, invoke xcmstest as follows:
		   % xcmstest -echo < tc/test1

CCAAVVEEAATTSS
       Color name strings passed to xcmstest commands cannot con-
       tain 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



X Version 11		    Release 6				1





XCMSTEST(1)					      XCMSTEST(1)


SSEEEE AALLSSOO
       xcmsdb(1), Chapter 6 of Xlib - C Language X Interface.

CCOOPPYYRRIIGGHHTT
       Copyright 1991, X Consortium




















































X Version 11		    Release 6				2