NAME

       xcmsdb - Device Color Characterization utility for X Color Management System

SYNOPSIS

       xcmsdb [ -query ] [ -remove ] [ -format 32|16|8 ] [ -help ] [ -version ] [ filename ]

DESCRIPTION

       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  device-
       independent  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

       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.

       -help   This option prints a summary of the available options and exits.

       -version
               This option prints the program version and exits.

SEE ALSO

       xprop(1), Xlib documentation

ENVIRONMENT

       DISPLAY to figure out which display and screen to use.

AUTHOR

       Chuck Adams, Tektronix Inc.  Al Tabayoyon, SynChromatics Inc. (added multi-visual support)