xcmsdb(1) [debian man page]

XCMSDB(1)						      General Commands Manual							 XCMSDB(1)

NAME

       xcmsdb - Device Color Characterization utility for X Color Management System

SYNOPSIS

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

DESCRIPTION

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

       Note that Xcms allows clients to register function sets in addition to its built-in function set for CRT color monitors.  Additional  func-
       tion 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.

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

AUTHOR

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

X Version 11							   xcmsdb 1.0.4 							 XCMSDB(1)

Check Out this Related Man Page

XcmsColor(3)							  XLIB FUNCTIONS						      XcmsColor(3)

NAME

       XcmsColor, XcmsRGB, XcmsRGBi, XcmsCIEXYZ, XcmsCIEuvY, XcmsCIExyY, XcmsCIELab, XcmsCIELuv, XcmsTekHVC, XcmsPad - Xcms color structure

STRUCTURES

       The structure for XcmsColor contains:

       typedef unsigned long XcmsColorFormat;		 /* Color Specification Format */

       typedef struct {
	    union {
		 XcmsRGB RGB;
		 XcmsRGBi RGBi;
		 XcmsCIEXYZ CIEXYZ;
		 XcmsCIEuvY CIEuvY;
		 XcmsCIExyY CIExyY;
		 XcmsCIELab CIELab;
		 XcmsCIELuv CIELuv;
		 XcmsTekHVC TekHVC;
		 XcmsPad Pad;
	    } spec;
	    unsigned long pixel;
	    XcmsColorFormat format;
       } XcmsColor;		/* Xcms Color Structure */

       typedef double XcmsFloat;

       typedef struct {
	    unsigned short red; /* 0x0000 to 0xffff */
	    unsigned short green;    /* 0x0000 to 0xffff */
	    unsigned short blue;     /* 0x0000 to 0xffff */
       } XcmsRGB;	   /* RGB Device */

       typedef struct {
	    XcmsFloat red; /* 0.0 to 1.0 */
	    XcmsFloat green;	/* 0.0 to 1.0 */
	    XcmsFloat blue;	/* 0.0 to 1.0 */
       } XcmsRGBi;	   /* RGB Intensity */

       typedef struct {
	    XcmsFloat X;
	    XcmsFloat Y;   /* 0.0 to 1.0 */
	    XcmsFloat Z;
       } XcmsCIEXYZ;	   /* CIE XYZ */

       typedef struct {
	    XcmsFloat u_prime;	/* 0.0 to ~0.6 */
	    XcmsFloat v_prime;	/* 0.0 to ~0.6 */
	    XcmsFloat Y;   /* 0.0 to 1.0 */
       } XcmsCIEuvY;	   /* CIE u'v'Y */

       typedef struct {
	    XcmsFloat x;   /* 0.0 to ~.75 */
	    XcmsFloat y;   /* 0.0 to ~.85 */
	    XcmsFloat Y;   /* 0.0 to 1.0 */
       } XcmsCIExyY;	   /* CIE xyY */

       typedef struct {
	    XcmsFloat L_star;	/* 0.0 to 100.0 */
	    XcmsFloat a_star;
	    XcmsFloat b_star;
       } XcmsCIELab;	   /* CIE L*a*b* */

       typedef struct {
	    XcmsFloat L_star;	/* 0.0 to 100.0 */
	    XcmsFloat u_star;
	    XcmsFloat v_star;
       } XcmsCIELuv;	   /* CIE L*u*v* */

       typedef struct {
	    XcmsFloat H;   /* 0.0 to 360.0 */
	    XcmsFloat V;   /* 0.0 to 100.0 */
	    XcmsFloat C;   /* 0.0 to 100.0 */
       } XcmsTekHVC;	   /* TekHVC */

       typedef struct {
	    XcmsFloat pad0;
	    XcmsFloat pad1;
	    XcmsFloat pad2;
	    XcmsFloat pad3;
       } XcmsPad;	   /* four doubles */

DESCRIPTION

       The XcmsColor structure contains a union of substructures, each supporting color specification encoding for a particular color space.

SEE ALSO

       XcmsAllocColor(3), XcmsStoreColor(3), XcmsConvertColors(3),

       Xlib - C Language X Interface

X Version 11							   libX11 1.6.0 						      XcmsColor(3)

Linux and UNIX Man Pages

xcmsdb(1) [debian man page]

Check Out this Related Man Page