xcmscolorspace(3) [hpux man page]

XcmsColorSpace()														  XcmsColorSpace()

Name
  XcmsColorSpace - Xcms color space structure.

Availability
  Release 5 and later.

Description
  The  XcmsColorSpace  structure contain the information necessary to convert the encoding of color specifications to other color spaces, and
  to parse a color string encoded specifically for this color space.

  The prefix member points to a string that identifies that a color strings encoding is for this particular color space.

	 <color_space>:<color_space_specific_encoding>

  For example, the prefix "cieuvy:" for the color string "CIEuvY:0.119/0.545/0.254".  Although the prefix in the color string may be  entered
  in uppercase or lowercase, all characters of the prefix specified in the XcmsColorSpace must be in lowercase.

  The  id  member  is  predefined  if  the  color  space is registered with the X Consortium; otherwise assigned at run-time (see XcmsAddCol-
  orSpace()).

  The parseString member points to the color space specific string parsing function.

  The to_CIEXYZ member is pointer to an array of functions that, when executed in sequence, will convert a XcmsColor  structure  encoded  for
  this color space to the CIEXYZ encoding.

  The  from_CIEXYZ member is pointer to an array of functions that, when executed in sequence, will convert a XcmsColor structure encoded for
  CIEXYZ to this color space's encoding.

  The inverse_flag member if set (i.e., 1) indicates that for each function in the to_CIEXYZ list,  there  is  an  inverse  function  in  the
  from_CIEXYZ  list.  Note however that the corresponding order is reversed - the inverse of the first function in to_CIEXYZ will be the last
  function in  from_CIEXYZ.

Structures
  The XcmsColorSpace structure contains:

     typedef XcmsConversionProc *XcmsFuncListPtr;

     typedef struct _XcmsColorSpace {
	 char *prefix;
	 XcmsColorFormat id;
	 XcmsParseStringProc parseString;
	 XcmsFuncListPtr to_CIEXYZ;
	 XcmsFuncListPtr from_CIEXYZ;
	 int inverse_flag;
     } XcmsColorSpace;

See Also
  XcmsAddColorSpace(), XcmsAddFunctionSet(), XcmsFunctionSet, XcmsConversionProc, XcmsParseStringProc.

Xlib - Device-independent Color 												  XcmsColorSpace()

XcmsAllocNamedColor()													     XcmsAllocNamedColor()

Name
  XcmsAllocNamedColor - allocate a color specified as a string.

Synopsis
  Status XcmsAllocNamedColor(display, colormap, color_string,
  color_screen_return, color_exact_return,result_format)
	Display *display;
	Colormap colormap;
	char *color_string;
	XcmsColor *color_screen_return;
	XcmsColor *color_exact_return;
	XcmsColorFormat result_format;

Arguments
  display   Specifies the connection to the X server.

  colormap  Specifies the colormap.

  color_string
	    Specifies the color string whose color definition structure is to be returned.

  color_screen_return
	    Returns the pixel value of the color cell and color specification that actually is stored for that cell.

  color_exact_return
	    Returns  the color specification parsed from the color string or parsed from the corresponding string found in a color name data-
	    base.

  result_format
	    Specifies the desired color format for the returned color specification.

Returns
  Zero on failure, non-zero on success.

Description
  The XcmsAllocNamedColor() function is similar to XAllocNamedColor() except the color specification returned can be specified to be  in  any
  format  supported by the color management system.  This function ultimately calls XAllocColor() to allocate a read-only color cell with the
  color specified by a color string.  The color string is parsed into an XcmsColor structure, converted to an RGB value, then finally  passed
  to XAllocColor().

  The  color string may contain a color name that appears in the client-side or X server's color database; or a numerical color specification
  for any color management supported color spaces such that the string conforms to the uniform syntax:

	 <color_space>:<color_space_specific_encoding>

  For example:

     RGB:red/green/blue
     RGBi:R/G/B
     CIEXYZ:X/Y/Z
     CIEuvY:u/v/Y
     CIExyY:x/y/Y
     CIELab:L/a/b
     CIELuv:L/u/v
     TekHVC:H/V/C

  For the RGB color space, the red, green, and blue parameters are hexidecimal strings of one to four digits.  For each of  the  other	color
  spaces,  each  parameter  is a floating-point number in standard string format.  In each case, each number specifies a value for one of the
  parameters of the color space.  Old-style RGB color strings beginning with a "#" remain supported  for  backwards  compatibility.   If  the
  color name is not in the Host Portable Character Encoding the result is implementation-dependent.  Color names are case-insensitive.

  This	function  returns both the color specification as a result of parsing (exact specification) and the actual color specification stored
  (screen specification).  This screen specification is the result of converting the RGB value returned  by  XAllocColor()  into  the  format
  specified  by  result_format.   If  there  is  no  interest  in  a returned color specification, unnecessary computation can be bypassed if
  result_format is set to XcmsRGBFormat.

Errors
  BadColor  The colormap argument does not name a defined Colormap.

Structures
  The XcmsColor and XcmsColorFormat structures are shown on the XcmsColor reference page.

See Also
  XcmsAllocColor(), XcmsLookupColor(), XcmsQueryColor(), XcmsQueryColors(), XcmsStoreColor(), XcmsStoreColors(), XcmsStoreNamedColor, XAlloc-
  Color(), XAllocNamedColor(), XLookupColor(), XParseColor(), XQueryColor(), XQueryColors(), XStoreColor(), XStoreColors().

Xlib - Device-independent Color 											     XcmsAllocNamedColor()