xcmsdb(1x) [osf1 man page]
xcmsdb(1X) xcmsdb(1X) NAME
xcmsdb - Device Color Characterization utility for X Color Management System SYNOPSIS
xcmsdb [-query] [-remove] [-format 32 | 16 | 8] [filename] OPTIONS
xcmsdb program accepts the following options: This option attempts to read the XDCCC properties off the screen's root window. If success- ful, it transforms the data into a more readable format, then sends the data to standard out. This option attempts to remove the XDCCC properties on the screen's root window. 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. 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. ENVIRONMENT
to figure out which display and screen to use. SEE ALSO
xprop(1X) AUTHOR
Chuck Adams, Tektronix Inc.; Al Tabayoyon, SynChromatics Inc. (added multi-visual support) xcmsdb(1X)
Check Out this Related Man Page
XcmsLookupColor() XcmsLookupColor() Name XcmsLookupColor - obtain color values from a string. Synopsis Status XcmsLookupColor(display, colormap, color_string, color_exact_return, color_screen_return, result_format) Display *display; Colormap colormap; char *color_string; XcmsColor *color_exact_return; XcmsColor *color_screen_return; XcmsColorFormat result_format; Arguments display Specifies the connection to the X server. colormap Specifies the colormap. color_string Specifies the color string. color_exact_return Returns the color specification parsed from the color string or parsed from the corresponding string found in a color name data- base. color_screen_return Returns the color that can be reproduced on the Screen. result_format Specifies the desired color format for the returned color specifications. Returns Zero on failure, non-zero on success. Availability Release 5 and later. Description The XcmsLookupColor() function looks up the string name of a color with respect to the screen associated with the specified colormap, but does not store the color into any color cell in the color map. It returns both the exact color values and the closest values provided by the screen with respect to the visual type of the specified colormap. The values are returned in the format specified by result_format. The color string may contain a color name that appears in the client-side or X server's color database; or a numerical color specification for any color management supported color spaces such that the string conforms to the uniform syntax: <color_space>:<color_space_specific_encoding> For example: RGB:red/green/blue RGBi:R/G/B CIEXYZ:X/Y/Z CIEuvY:u/v/Y CIExyY:x/y/Y CIELab:L/a/b CIELuv:L/u/v TekHVC:H/V/C For the RGB color space, the red, green, and blue parameters are hexadecimal strings of one to four digits. For each of the other color spaces, each parameter is a floating-point number in standard string format. In each case, each number specifies a value for one of the parameters of the color space. Old-style RGB color strings beginning with a "#" remain supported for backwards compatibility. If the color name is not in the Host Portable Character Encoding the result is implementation-dependent. Color names are case-insensitive. If format is XcmsUndefinedFormat and the color string contains a numerical color specification, the specification is returned in the format used in that numerical color specification. If format is XcmsUndefinedFormat and the color string contains a color name, the specification is returned in the format used in the color name database entry for that color name. XcmsLookupColor() returns XcmsSuccess or XcmsSuccessWithCompression if the name is resolved, otherwise it returns XcmsFailure. If XcmsSuc- cessWithCompression is returned, then the color specification in color_screen_return is the result of gamut compression. Structures The XcmsColor and XcmsColorFormat structures are shown on the XcmsColor reference page. See Also XcmsAllocColor(), XcmsAllocNamedColor(), XcmsLookupColor(), XcmsQueryColor(), XcmsQueryColors(), XcmsStoreColor(), XcmsStoreColors(), Xcms- StoreNamedColor, XAllocColor(), XAllocNamedColor(), XLookupColor(), XParseColor(), XQueryColor(), XQueryColors(), XStoreColor(), XStoreCol- ors(). Xlib - Device-independent Color XcmsLookupColor()