>># 
>># Copyright 1990, 1991 by the Massachusetts Institute of Technology and
>># UniSoft Group Limited.
>># 
>># Permission to use, copy, modify, distribute, and sell this software and
>># its documentation for any purpose is hereby granted without fee,
>># provided that the above copyright notice appear in all copies and that
>># both that copyright notice and this permission notice appear in
>># supporting documentation, and that the names of MIT and UniSoft not be
>># used in advertising or publicity pertaining to distribution of the
>># software without specific, written prior permission.  MIT and UniSoft
>># make no representations about the suitability of this software for any
>># purpose.  It is provided "as is" without express or implied warranty.
>># 
>># $XConsortium: qryclrs.m,v 1.10 92/06/11 16:17:16 rws Exp $
>># 
>>#      SCCS:  @(#)  ECol.mc Rel 1.4	    (7/31/91)
>>#
>>TITLE XQueryColors CH05
>>ASSERTION A XQueryColors-1
A call to XQueryColors obtains the RGB values of the
colourmap entries specified by the pixel components of the
XColor structures named by the defs_in_out argument, and
returns the RGB values in the red, green, and blue
components and sets the flags components to the bitwise OR
of DoRed, DoGreen, and DoBlue.
>>STRATEGY
For each supported visual class :
  Create a colormap with XCreateColormap with alloc = AllocNone.
  Allocate a new r/o colourmap cell with XAllocColor.
  Obtain the rgb values and flags components with XQueryColors using the pixel returned by XAllocCOlor.
  Verify that the returned flags component was set to DORed|DoGreen|DoBlue.
  Verify that the rgb values are identical to those returned by XAllocColor.
>>ASSERTION A XQueryColors-2
When a colourmap argument does not name a valid colourmap,
then a BadColor error occurs.
>>STRATEGY
Create a bad colourmap by creating and freeing a colourmap.
Call test function using bad colourmap as the colourmap argument.
Verify that a BadColor error occurs.
>>ASSERTION A XQueryColors-3
When the pixel component in one or more of the ncolors
XColor structures named by the defs_in_out argument is not a
valid entry in the colormap argument, then a BadValue error
occurs which will report any one of the invalid pixel
values.
>>STRATEGY
For each supported visual class:
  Create a colormap with XCreateColormap with alloc set to AllocNone.
  Allocate a r/o colormap cell with XAllocColor.
  Call XQueryColors with pixel array comprising pixel components 0L, -1L, -2L.
  Verify that a BadValue error occurs.
  Verify that the reported BadValue was either -1 or -2.
