author | Sam Lau <Sam.Lau@Sun.COM> |
Tue, 30 Sep 2008 10:13:12 -0700 | |
changeset 550 | 3b62053c3b77 |
child 905 | d2b59d5a79ed |
permissions | -rw-r--r-- |
550
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
1 |
.\" Copyright 1995 Sun Microsystems, Inc. All rights reserved. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
2 |
.\" Use subject to license terms. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
3 |
.\" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
4 |
.\" Permission is hereby granted, free of charge, to any person obtaining a |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
5 |
.\" copy of this software and associated documentation files (the |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
6 |
.\" "Software"), to deal in the Software without restriction, including |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
7 |
.\" without limitation the rights to use, copy, modify, merge, publish, |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
8 |
.\" distribute, and/or sell copies of the Software, and to permit persons |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
9 |
.\" to whom the Software is furnished to do so, provided that the above |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
10 |
.\" copyright notice(s) and this permission notice appear in all copies of |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
11 |
.\" the Software and that both the above copyright notice(s) and this |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
12 |
.\" permission notice appear in supporting documentation. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
13 |
.\" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
14 |
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
15 |
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
16 |
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
17 |
.\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
18 |
.\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
19 |
.\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
20 |
.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
21 |
.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
22 |
.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
23 |
.\" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
24 |
.\" Except as contained in this notice, the name of a copyright holder |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
25 |
.\" shall not be used in advertising or otherwise to promote the sale, use |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
26 |
.\" or other dealings in this Software without prior written authorization |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
27 |
.\" of the copyright holder. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
28 |
.TH cmap_compact 1 "11 July 1995" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
29 |
.IX "cmap_comapct" "" "\f3cmap_compact\f1(1) \(em utility to reduce colormap flashing" "" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
30 |
.IX "color" "prev" "color" "preventing flashing \(em \f3cmap_compact\f1(1)" "" |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
31 |
.SH NAME |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
32 |
cmap_compact \- colormap configuration utility to reduce colormap flashing. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
33 |
.SH SYNOPSIS |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
34 |
.B cmap_compact |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
35 |
[ |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
36 |
.B \\fIop\f1 |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
37 |
] [ |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
38 |
.B \-display |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
39 |
.I dpyname |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
40 |
] |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
41 |
.SH DESCRIPTION |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
42 |
.LP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
43 |
.B cmap_compact |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
44 |
is a utility which allows certain colors to be designated as special |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
45 |
and to be promoted to the high end of the default colormap (toward pixel 255). |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
46 |
This reduces colormap flashing in many situations. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
47 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
48 |
This technique has no effect for monochrome screens; it applies only to |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
49 |
color screens. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
50 |
.SH OPTIONS |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
51 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
52 |
\f3-display\f1 \fIdpyname\f1 |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
53 |
Indicates the X11 display to use. ':0' is the default. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
54 |
.LP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
55 |
\fIop\f1 can be one of the following operations: |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
56 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
57 |
.B save |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
58 |
Records the RGB color values of all shareable (read-only) colors in the |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
59 |
default colormap for each active screen and saves these values on |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
60 |
the file \f3~/.owcolors\f1. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
61 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
62 |
The black and white pixels (typically at pixels 254 and 255) are ignored |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
63 |
during the save. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
64 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
65 |
Note that all colors are ignored for screens with a StaticColor default colormap. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
66 |
Note also that the server is grabbed during the save. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
67 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
68 |
.B init |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
69 |
Reads the colors which have been saved in \f3~/.owcolors\f1 and allocates |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
70 |
them as read-only colors at the high-end of the default colormap. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
71 |
The color allocations for those applications which use these colors |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
72 |
will be derived from these high colors. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
73 |
If there is no \f3~/.owcolors\f1 file, nothing happens and no message |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
74 |
is printed out. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
75 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
76 |
The colors are allocated in reverse order of the order in which they |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
77 |
were saved. Thus, the lowest pixel in the colormap at save time |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
78 |
becomes the highest pixel at initialization time. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
79 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
80 |
This operation is typically invoked from \f3~/.xinitrc\f1 prior to |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
81 |
starting the color applications. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
82 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
83 |
This operation creates on the root window of each screen a property named |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
84 |
\fIXA_COMPACTED_COLORS_COUNT\f1 of type XA_INTEGER. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
85 |
The value of this property specifies the number of initialized colors for that screen. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
86 |
Note: this value also includes the black and white pixels. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
87 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
88 |
An X11 \fIclose down mode\f1 of \f3RetainPermanent\f1 is set so that |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
89 |
the colors this program allocates will stay around after \f3cmap_compact\f1 |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
90 |
exits. These colors may be freed by calling \f3cmap_compact\ dealloc\f1 . |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
91 |
Before this program allocates its colors, it frees any colors left |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
92 |
over from a previous invocation. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
93 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
94 |
If there are more saved colors than can fit in the default colormap, |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
95 |
as many colors as will fit are allocated and a warning message |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
96 |
is printed out. This situation, for example, might occur if the |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
97 |
the default visual were switched from an 8-bit to a 4-bit visual |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
98 |
without discarding saved colors. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
99 |
.PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
100 |
Note: no allocations occur for screens with a StaticColor default colormap. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
101 |
.br |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
102 |
Note: The server is grabbed during the initialization. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
103 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
104 |
.B discard |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
105 |
This operation removes the file \f3~/.owcolors\f1. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
106 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
107 |
.B dealloc |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
108 |
This operation frees colors allocated by a previous invocation of |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
109 |
.BR cmap_compact\ init . |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
110 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
111 |
.B show |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
112 |
This operation prints out the RGB values of the saved colors for each screen. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
113 |
.\" .SH EFFECT ON THE X11 SERVER |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
114 |
.\" .LP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
115 |
.\" The |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
116 |
.\" .BR Xsun (1) |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
117 |
.\" server also reads the file \f3~/.owcolors\f1 to |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
118 |
.\" determine the amount that it should shift down the color cube |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
119 |
.\" in the StaticColor colormap (this is called the \fIcube offset\f1). |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
120 |
.\" .PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
121 |
.\" Because there is only a single StaticColor colormap in the server, |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
122 |
.\" a decision must be made about how to handle different numbers of |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
123 |
.\" saved workspace colors on different screens. The server currently |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
124 |
.\" takes the simplest approach: the cube offset is the number of |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
125 |
.\" saved colors for the screen with the largest number of colors. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
126 |
.\" .PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
127 |
.\" The cube offset does not include the black and white pixels because |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
128 |
.\" these pixels are not shifted down with the rest of the cube; these |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
129 |
.\" pixels stay at the high end of the StaticColor colormap. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
130 |
.\" .PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
131 |
.\" No matter what the value of the cube offset, the base pixel of the cube |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
132 |
.\" is always greater or equal to 0. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
133 |
.\" .PP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
134 |
.\" In addition to shifting the StaticColor color cube downward (toward 0) |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
135 |
.\" to avoid flashing with the saved colors, the black and white pixels |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
136 |
.\" which are allocated in the default colormap are moved to the high |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
137 |
.\" end of the default colormap (toward 255). |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
138 |
.SH FILES |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
139 |
.TP |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
140 |
\f3~/.owcolors\f1 |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
141 |
The file which is generated by |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
142 |
.BR cmap_compact\ save . |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
143 |
Contains a list of saved, read-only workspace colors for all screens. |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
144 |
.SH SEE ALSO |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
145 |
.BR Xsun (1) |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
146 |
.br |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
147 |
.SH BUGS |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
148 |
Currently does not support using the same \f3~/.owcolors\f1 file |
3b62053c3b77
6730028 Moving /usr/openwin/lib/mkcookie to /usr/X11/lib
Sam Lau <Sam.Lau@Sun.COM>
parents:
diff
changeset
|
149 |
for different machine architectures. |