rgb(1)

rgb compiler for X11

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

rgb - rgb compiler for X11

SYNOPSIS

rgb

DESCRIPTION

rgb reads a sorted file containing the red-green-blue values for a color and the color name. The compiler verifies the values of the rgb values and adds the values and the color name to a database file. The format of each entry in the file is as follows. red_value <separator> green_value <separator> blue_value <separator> color_name The values for the individual color components can range from 0 through 255. The color name can be up to 41 characters long, excluding the null terminator; anything after the 41st character is truncated. The separator can be any white space character. The file is set up so that the color values are separated by a space character and the last color value and the color name are separated by 2 or 3 tab characters (whichever is needed to align the last column in the file).

NAMING CONVENTIONS

The naming convention is to use the names rgb.<display_type>.txt for the rgb source file and rgb.<display_type>.base for the compiled rgb file.

OPTIONS

Since the server performs a binary search on the color name,
the  database  must  be  sorted  according to the color name
before being compiled.  Sed is used to change  the  multiple
tabs  into  a  single  space before the file is sorted.  The
following command is used to  sed,  sort,  and  compile  the
database and direct the output to rgb.<display_type>.base.
/bin/sed "s/[  ][   ]*/ /g" < rgb.display_type.txt | sort -f +3 |
 ../bin/rgb rgb.display_type.base
The data within each square bracket pair is a  single  space
character followed by a single tab character.

DIRECTORY SPECIFICATION

The directory containing the rgb database must be specified for the server. Normally it is /usr/X/lib/rgb.<display_type> . The server appends .base to the file name before reading it.