man pages section 1: User Commands

Exit Print View

Updated: July 2014

xcmsdb (1)


xcmsdb - Device Color Characterization utility for X Color Management System


/usr/bin/xcmsdb [ -query ] [ -remove ] [ -format 32|16|8 ] [
filename ]


User Commands                                           XCMSDB(1)

     xcmsdb  -  Device Color Characterization utility for X Color
     Management System

     /usr/bin/xcmsdb [ -query ] [ -remove ] [ -format 32|16|8 ] [
     filename ]

     xcmsdb  is used to load, query, or remove Device Color Char-
     acterization data stored in properties on the root window of
     the  screen  as specified in section 7, Device Color Charac-
     terization, 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  Inten-
     sity  (XcmsRGBi, also referred to as linear RGB).  Xcms then
     uses display gamma  information  stored  in  the  XDCCC_LIN-
     EAR_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  moni-
     tors.   Additional function sets may store their device pro-
     file information in other properties in  function  set  spe-
     cific format.  This utility is unaware of these non-standard

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

     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

X Version 11        Last change: xcmsdb 1.0.4                   1

User Commands                                           XCMSDB(1)

             with the increase in bits per entry.  The default is
             32 bits per entry.

     xprop(1), Xlib documentation

     DISPLAY to figure out which display and screen to use.

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

     See  attributes(5)  for  descriptions   of   the   following

     |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
     |Availability                 |x11/x11-server-utilities     |
     |Interface Stability          |Committed                    |

X Version 11        Last change: xcmsdb 1.0.4                   2