XCMSDB(1)                       X11 R4.11MU05                      XCMSDB(1)


NAME
       xcmsdb - Xlib Screen Color Characterization Data utility

SYNOPSIS
       xcmsdb [-option ...] [filename]

DESCRIPTION
       xcmsdb is used to load, query, or remove Screen Color
       Characterization Data stored in properties on the root window of the
       screen.  Screen Color Characterization Data is an integral part of
       Xlib, necessary for proper conversion between device-independent and
       device-dependent color specifications.  Xlib uses the
       XDCCC_LINEAR_RGB_MATRICES and XDCCC_LINEAR_RGB_CORRECTION properties
       to store color characterization data for color monitors.  It uses
       XDCCC_GRAY_SCREENWWHITEPOINT and XDCCC_GRAY_CORRECTION properties for
       gray scale monitors.  Because Xlib allows the addition of Screen
       Color Characterization Function Sets, added function sets may place
       their Screen Color Characterization Data on other properties.  This
       utility is unaware of these other properties, therefore, you will
       need to use a similar utility provided with the function set, or use
       the xprop utility.

       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.

       -color  This option sets the query and remove options to only check
               for the XDCCC_LINEAR_RGB_MATRICES and
               XDCCC_LINEAR_RGB_CORRECTION properties.  If the -color option
               is not set then the query and remove options check for all
               the properties.

       -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
       xprop(1), Xlib documentation

ENVIRONMENT
       DISPLAY to figure out which display and screen to use.

BUGS
       Unknown

COPYRIGHT
       Copyright 1990, Tektronix Inc.

AUTHOR
       Chuck Adams, Tektronix Inc.


Licensed material--property of copyright holder(s)