xcmsdb(1)

NAME

xcmsdb − Xlib Screen Color Characterization Data utility

SYNOPSIS

xcmsdb [−option ...] [filename]

DESCRIPTION

xcmsdb is used to load, query, or remove Device Color Characterization data stored in properties on the root window of the screen (i.e.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).

This code has been enhanced to optionally read International Color Consortium (ICC) monitor profiles which have been configured and calibrated to the user’s monitor and to load the root window properties with this per-visual profile data. It will also optionally create an output Device Color Characterization (.dcc) file of the same data. This capability is only available if the Kodak Color Management System (KCMS) packages have been added to your system and you have configured your system by specifying your monitor profile via the KCMS programs "kcms_calibrate" or "kcs_configure". This enhanced code also includes the additional x-visuals description code included in MIT version R6.

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.

−profile
This option looks for the configured visual profiles created via the KCMS library routines. If your system has been configured to use the Kodak Color Management System framework, these visual profiles will be in a known location for KCMS to access. If filename is included with this option, then a .dcc file will also be created from the visual profile data and written to the current directory.

−remove
This option attempts to remove the XDCCC properties on the screen’s root window.

−display host:display.screennumber
This option allows the user to load root window properties into screens other than the default screen number 0. This is applicable to multi-headed workstations.

−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.

EXAMPLES

To read a .dcc file and updte the root window properties:

xcmsdb multi.dcc

To inquire on the root window properties on another screen:

xcmsdb -query -display solar:0.1

To load the root window properties with Kcs visual profile data and save that data in a .dcc file:

xcmsdb -profile savedata.dcc

ENVIRONMENT

DISPLAY
to figure out which display and screen to use.

BUGS

Unknown

COPYRIGHT

AUTHOR

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

SunSoft enhancements included to use KCMS.

X Version 11 — Last change: Release 5

Museum

Related Articles