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