1 .TH COLORS 1
2 .SH NAME
3 getmap, colors \- display color map
4 .SH SYNOPSIS
5 .PP
6 .B colors
7 [
8 .B -r
9 .B -x
10 ]
11 .PP
12 .B getmap
13 [
14 .I colormap
15 ]
16 .SH DESCRIPTION
17 .I Colors
18 presents a grid showing the colors in the current color map.
19 If the display is true color,
20 .I colors
21 shows a grid of the RGBV color map
22 (see
23 .IR color (7)).
24 .PP
25 Clicking mouse button 1 over a color in the grid will display the map index for that color,
26 its
27 red, green, and blue components,
28 and the 32-bit hexadecimal color value as defined in
29 .IR allocimage (3).
30 If the
31 .B -x
32 option is specified, the components will also be listed in hexadecimal.
33 .PP
34 The
35 .B -r
36 option instead shows, in the same form, a grey-scale ramp.
37 .PP
38 A menu on mouse button 3 contains a single entry, to exit the program.
39 .PP
40 On 8-bit color-mapped displays,
41 .I getmap
42 loads the display's color map (default
43 .BR rgbv ).
44 The named
45 .I colormap
46 can be a file in the current directory or in the standard repository
47 .BR /lib/cmap .
48 It can also be a string of the form
49 .B gamma
50 or
51 .BI gamma N\f1 ,
52 where
53 .I N
54 is a floating point value for the gamma, defining the contrast for a monochrome map.
55 Similarly,
56 .B rgamma
57 and
58 .BI rgamma N
59 define a reverse-video monochrome map.
60 Finally, the names
61 .B screen
62 or
63 .B display
64 or
65 .B vga
66 are taken as synonyms for the current color map stored in the display hardware.
67 .SH FILES
68 .B /lib/cmap
69 directory of color map files
70 .SH SOURCE
71 .B /usr/local/plan9/src/cmd/draw/colors.c
72 .SH SEE ALSO
73 .IR color (7)