.TH xcmsdb "" "" "X Utility"
.PC "Manipulate xlib screen-color characterization data"
\fBxcmsdb [\-color] [\-format [32|16|8]\^] [\-query] [\-remove] [\fIfilename\^\fB]\fR
.PP
.HS
.SH Options:
.IC \fB\-color\fR
Limit the options \fB\-query\fR and \fB\-remove\fR
so that they check only for the properties
\fBXDCCC_LINEAR_RGB_MATRICES\fR
and
\fBXDCCC_LINEAR_RGB_CORRECTION\fR
.IC "\fB\-format [32|16|8]\fR"
Specify the format for the property
\fBXDCCC_LINEAR_RGB_CORRECTION\fR
.IC \fB\-query\fR
Read the \fBXDCCC\fR
properties from the screen's root window, and write the
digested information to the standard output
.IC \fB\-remove\fR
Remove the \fBXDCCC\fR properties from the screen's root window
.HE
.B xcmsdb
can load, query, or remove the Screen Color Characterization Data (SCCD)
stored within a property on the screen's root window.
The SCCD are an integral part of
.BR xlib ;
applications need them to convert properly between
device-independent and device-dependent color specifications.
.PP
.B xlib
uses the following properties:
.IP \fBXDCCC_LINEAR_RGB_MATRICES\fR
.IS \fBXDCCC_LINEAR_RGB_CORRECTION\fR
Store color-characterization data for color monitors.
.IP \fBXDCCC_GRAY_SCREENWWHITEPOINT\fR
.IS \fBXDCCC_GRAY_CORRECTION\fR
Store data for gray-scale monitors.
.PP
Because
.B xlib
allows the addition of Screen Color Characterization Function Sets,
an added function sets may place its SCCD onto other properties.
.B xcmsdb
is unaware of these other properties;
therefore, you must use a similar utility provided with the function set,
or use the utility
.BR xprop .
.PP
.B xcmsdb
transforms the contents of
.I filename
(or the standard input if the command line has no
.IR filename )
for storage within properties, provided its
command line does not specify the options
.B \-query
or 
.BR \-remove .
.PP
.B xcmsdb
recognizes the following command-line options:
.IP \fB\-color\fR
Limit the options
.B \-query
and
.B \-remove
(described below)
so that they check only for the properties
.B XDCCC_LINEAR_RGB_MATRICES
and
.BR XDCCC_LINEAR_RGB_CORRECTION .
If you do not set this option,
options
.B \-query
and
.B \-remove
check for all properties.
.IP "\fB\-format [32|16|8]\fR"
Specify the format for the property
.BR XDCCC_LINEAR_RGB_CORRECTION .
Flags
.BR 32 ,
.BR 16 ,
and
.B 8
set the number of bits per entry;
the more bits, the greater the precision of encoded floating-point values.
The default is 32 bits per entry.
.IP \fB\-query\fR
Read the
.B XDCCC
properties from the screen's root window.
If successful,
.B xcmsdb
transforms the data into a more readable format, then
writes them to the standard-output device.
.IP \fB\-remove\fR
Remove the
.B XDCCC
properties from the screen's root window.
.SH Environment
.B xcmsdb
reads the environmental variable
.B DISPLAY
to find the display and screen to use.
.SH "See Also"
.B
xprop,
X utilities
.R
.SH Notes
Copyright \(co 1990, Tektronix Inc.
.PP
.II "Adams, Chuck"
.B xcmsdb
was written by Chuck Adams of Tektronix, Inc.
