XCMSDB(1)                      X Version 11                       XCMSDB(1)
                                 Release 6.1



 NAME    [Toc]    [Back]
      xcmsdb - Device Color Characterization utility for X Color Management
      System

 SYNOPSIS    [Toc]    [Back]
      xcmsdb [ -query ] [ -remove ] [ -format 32|16|8 ] [ filename ]

 DESCRIPTION    [Toc]    [Back]
      xcmsdb is used to load, query, or remove Device Color Characterization
      data stored in properties on the root window of the screen as
      specified in section 7, Device Color Characterization, of the ICCCM.
      Device Color Characterization data (also called the Device Profile) is
      an integral part of Xlib's X Color Management System (Xcms), necessary
      for proper conversion of color specification between deviceindependent
 and device-dependent forms.  Xcms uses 3x3 matrices stored
      in the XDCCC_LINEAR_RGB_MATRICES property to convert color
      specifications between CIEXYZ and RGB Intensity (XcmsRGBi, also
      referred to as linear RGB).  Xcms then uses display gamma information
      stored in the XDCCC_LINEAR_RGB_CORRECTION property to convert color
      specifications between RGBi and RGB device (XcmsRGB, also referred to
      as device RGB).  Note that Xcms allows clients to register function
      sets in addition to its built-in function set for CRT color monitors.
      Additional function sets may store their device profile information in
      other properties in function set specific format.  This utility is
      unaware of these non-standard properties.  The ASCII readable contents
      of filename (or the standard input if no input file is given) are
      appropriately transformed for storage in properties, provided the
      -query or -remove options are not specified.

 OPTIONS    [Toc]    [Back]
      xcmsdb program accepts the following options:

      -query  This option attempts to read the XDCCC properties off the
              screen's root window.  If successful, it transforms the data
              into a more readable format, then sends the data to standard
              out.

      -remove This option attempts to remove the XDCCC properties on the
              screen's root window.

      -format 32|16|8
              Specifies the property format (32, 16, or 8 bits per entry)
              for the XDCCC_LINEAR_RGB_CORRECTION property.  Precision of
              encoded floating point values increases with the increase in
              bits per entry.  The default is 32 bits per entry.

 SEE ALSO    [Toc]    [Back]
      xprop(1), Xlib documentation

 ENVIRONMENT    [Toc]    [Back]




 Hewlett-Packard Company            - 1 -             HP-UX 11.23 March 2003






 XCMSDB(1)                      X Version 11                       XCMSDB(1)
                                 Release 6.1



      DISPLAY to figure out which display and screen to use.

 AUTHOR    [Toc]    [Back]
      Chuck Adams, Tektronix Inc.  Al Tabayoyon, SynChromatics Inc. (added
      multi-visual support)


 Hewlett-Packard Company            - 2 -             HP-UX 11.23 March 2003