xcol(1) MachTen Programmer’s Manual xcol(1)

NAME
xcol - change color-entries in textfiles

SYNOPSIS
xcol [-options ...] [filename]

DESCRIPTION
XCol displays the colors defined in the rgb.txt-file of
the XServer. The colors are sorted by their names and
their RGB-values and shown in a cube in the ColorView-
Window (The positions represent the RGB-values). Since
there usually are more colors defined in the file than
cells in the colormap, entries with the same name but dif-
ferent RGB-values for different intensities, are grouped
together.

If a filename is given as a parameter, all occurrences of
color-names in that file are shown in an additional
TextView-Window. To change the colors, a text-line has to
be made active. Afterwards a new color can be selected in
the ColorView-Window. To get a better impression of the
color, a help-color (background) can be selected for each
text-line. If 2 lines define a foreground and a background
color, an association can be made and the colors of both
lines can be selected together.

BUTTONS
in ColorView-Window

left: select color for the active line.
middle: select help-color for the active line.
right: warp pointer to color of active line.

in TextView-Window

left: select line as active line.
middle: toggle reverse-mode or
connect/disconnect 2 lines.
right: show line in the textfile.

OPTIONS
-rv Color-positions are reversed in the cube. Some new
colors can become visible in the area of the very
bright colors.

-b<n> The size of color blocks is set to the constant
<n>. By default, it depends on the size of the
ColorView-Window.

-gran<n>
The maximum number of associated colors is set to
<n>. By default, this value is 11. (You can see
the effect when reaching the grey-field, where 101
associated entries are possibly available.)

-dark<n>
The percentage of the intensity of other colors
can be set (default: 50). It is easier to select a
color, if the screen is darkened a little bit.

+<char_list>
add characters to list of ’space’-chars. The
color-string in the textfile has to occur between
2 ’space’-chars to be recognized. By default,
these letters are ’ ’, ’’, ’0, ’:’, ’"’.

-strings
Names of colors in the file are only recognized
when used in a string (useful for C-Sources). This
means that the list of ’space’-chars is set to ’"’
only.

-case All occurrences of color-names in wrong case are
replaced by the color-name of the ’rgb.txt’-file.

-help print some instructions (usage of buttons).

-file <name>
name of a different ’rgb.txt’-file.

FILES
/usr/lib/X11/rgb.txt