Debian Codegraph @

upstream/debian-unstable/man1/xcmsdb.1

raw
1 .\" $Xorg: xcmsdb.man,v 1.4 2001/02/09 02:05:39 xorgcvs Exp $
2 .\" Copyright 1990, Tektronix Inc.
3 .\" Copyright 1993, 1998 The Open Group
4 .\"
5 .\" Permission to use, copy, modify, distribute, and sell this software and its
6 .\" documentation for any purpose is hereby granted without fee, provided that
7 .\" the above copyright notice appear in all copies and that both that
8 .\" copyright notice and this permission notice appear in supporting
9 .\" documentation.
10 .\"
11 .\" The above copyright notice and this permission notice shall be included in
12 .\" all copies or substantial portions of the Software.
13 .\"
14 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 .\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
18 .\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
19 .\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
20 .\" SOFTWARE.
21 .\"
22 .\" Except as contained in this notice, the name of The Open Group shall not
23 .\" be used in advertising or otherwise to promote the sale, use or other
24 .\" dealing in this Software without prior written authorization from the
25 .\" The Open Group.
26 .\"
27 .\" $XFree86: xc/programs/xcmsdb/xcmsdb.man,v 1.6 2001/01/27 18:21:09 dawes Exp $
28 .\"
29 .TH XCMSDB 1 "xcmsdb 1.0.7" "X Version 11"
30 .SH NAME
31 xcmsdb \- Device Color Characterization utility for X Color Management System
32 .SH SYNOPSIS
33 .B xcmsdb
34 [ \fB\-query\fP ] [ \fB\-remove\fP ]
35 [ \fB\-format\032\fP|\fB16\fP|\fB8\fP ]
36 [ \fB\-help\fP ] [ \fB\-version\fP ]
37 [ \fIfilename\fP ]
38 .SH DESCRIPTION
39 .I xcmsdb
40 is used to load, query, or remove Device Color Characterization data
41 stored in properties on the root window of the screen as specified
42 in section 7, Device Color Characterization, of the ICCCM.
43 Device Color Characterization data (also called the Device Profile)
44 is an integral part of Xlib's X Color Management System (Xcms), necessary
45 for proper conversion of color specification between device-independent
46 and device-dependent forms.
47 Xcms uses 3x3 matrices stored in the XDCCC_LINEAR_RGB_MATRICES property to
48 convert color specifications between CIEXYZ and RGB Intensity (XcmsRGBi, also
49 referred to as linear RGB).
50 Xcms then uses display gamma information stored in the
51 XDCCC_LINEAR_RGB_CORRECTION property to convert color specifications between
52 RGBi and RGB device (XcmsRGB, also referred to as device RGB).
53 .LP
54 Note that Xcms allows clients to register \fIfunction sets\fP
55 in addition to its
56 built-in function set for CRT color monitors. Additional function sets
57 may store their device profile information in other properties in function
58 set specific format.
59 This utility is unaware of these non-standard properties.
60 .LP
61 The ASCII readable contents of
62 .I filename
63 (or the standard input if no input file is given)
64 are appropriately transformed for storage in properties, provided the
65 .B \-query
66 or
67 .B \-remove
68 options are not specified.
69 .SH "OPTIONS"
70 .I xcmsdb
71 program accepts the following options:
72 .TP 8
73 .B \-query
74 This option attempts to read the XDCCC properties off the screen's root
75 window.
76 If successful, it transforms the data into a more readable format, then
77 sends the data to standard out.
78 .TP 8
79 .B \-remove
80 This option attempts to remove the XDCCC properties on the screen's root
81 window.
82 .TP 8
83 \fB\-format\032\fP|\fB16\fP|\fB8\fP
84 Specifies the property format (32, 16, or 8 bits per entry) for the
85 XDCCC_LINEAR_RGB_CORRECTION property.
86 Precision of encoded floating point values increases with the increase
87 in bits per entry.
88 The default is 32 bits per entry.
89 .TP 8
90 .B \-help
91 This option prints a summary of the available options and exits.
92 .TP 8
93 .B \-version
94 This option prints the program version and exits.
95 .SH "SEE ALSO"
96 xprop(1), Xlib documentation
97 .SH ENVIRONMENT
98 .TP 8
99 .B DISPLAY
100 to figure out which display and screen to use.
101 .SH AUTHOR
102 Chuck Adams, Tektronix Inc.
103 Al Tabayoyon, SynChromatics Inc. (added multi-visual support)