.TH COLORS 1
.SH NAME
getmap, colors \- display color map
.SH SYNOPSIS
.PP
.B colors
[
.B -rx
]
.PP
.B getmap
[
.I colormap
]
.SH DESCRIPTION
.I Colors
presents a grid showing the colors in the current color map.
If the display is true color,
.I colors
shows a grid of the RGBV color map
(see
.IR color (6)).
.PP
Clicking mouse button 1 over a color in the grid will display the map index for that color,
its
red, green, and blue components,
and the 32-bit hexadecimal color value as defined in
.IR allocimage (2).
If the
.B -x
option is specified, the components will also be listed in hexadecimal.
.PP
The
.B -r
option instead shows, in the same form, a grey-scale ramp.
.PP
A menu on mouse button 3 contains a single entry, to exit the program.
.PP
On 8-bit color-mapped displays,
.I getmap
loads the display's color map (default
.BR rgbv ).
The named
.I colormap
can be a file in the current directory or in the standard repository
.BR /lib/cmap .
It can also be a string of the form
.B gamma
or
.BI gamma N\f1 ,
where
.I N
is a floating point value for the gamma, defining the contrast for a monochrome map.
Similarly,
.B rgamma
and
.BI rgamma N
define a reverse-video monochrome map.
Finally, the names
.B screen
or
.B display
or
.B vga
are taken as synonyms for the current color map stored in the display hardware.
.SH FILES
.B /lib/cmap
directory of color map files
.SH SOURCE
.B /sys/src/cmd/colors.c
.SH SEE ALSO
.IR color (6)