Commands Reference, Volume 6

xcmsdb Command

Purpose

Loads, queries, or removes Screen Color Characterization Data stored in properties on the root window of the screen.

Note: The xcmsdb command is only supported in X11R5 (AIXwindows Version 1.2.3).

Syntax

xcmsdb [ -display Display ] [ [ -query ] [ -remove ] [ -color ] ] | [ -format 32 | 16 | 8 ] [ FileName ]

The xcmsdb command 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, which is 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 example xprop utility.

The ASCII readable contents of the FileName parameter (or the standard input if no input file is given) are appropriately transformed for storage in properties, provided the -query or -remove flag options are not specified.

Note: The Xcms API in libX11.a is supported; however, the client side color name data base, /usr/lib/X11/Xcms.txt, and a device color characterization file, /usr/lib/X11/XcmsIBM5081.dcc, are provided as unsupported samples.

Flags

-displayDisplay	Specifies the server to which you are converting.
- query	Reads or attempts to read the XDCCC properties off the screen's root window. If successful, it transforms the data into a more readable format, and then sends the data to standard output.
-remove	Removes or attempts to remove the XDCCC properties on the screen's root window.
-color	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, 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.

Parameter

FileName

Specifies the ASCII readable contents of a Screen Color Characterization Data file.

Examples

Use the following example to put Screen Color Characterization Data on the root window by telling the xcmsdb command to read it from a file:
```
xcmsdb /usr/lib/X11/XcmsIBM5081.dcc
```
Use the following example after you have already put Screen Color Characterization Data on the root window to tell the xcmsdb command to read the data back if it exists:
```
xcmsdb -query
```