NAME

       xcolors - display all X11 color names and colors

SYNOPSIS

       xcolors [ -start color ] [ -near color ] [ -distance howfar ]

DESCRIPTION

       xcolors  reads  the  rgb.txt  file  that  defines  the  color names the X server knows and
       displays the colors found.

       At the top of the window is a sample region containing text.  By  clicking  on  the  color
       names,  the  color  of  the  sample  text  can  be  changed.   Mouse  button 1 changes the
       foreground; button 2 changes the background.  The text can also be edited.

       Typing ``q'' exits the program.

OPTIONS

       In addition the the usual X  Toolkit  options,  xcolors  understands  these  command  line
       options:

       -start name
              specify  a color name to start with; colors before this one in the rgb.txt file are
              skipped.  This option is useful if there are more colors  than  will  fit  on  your
              screen or in your colormap.

       -rgbfile filename
              specify an alternate color database file to read.

       -near nearcolor
              only show colors near this one in the RGB space.  All colors within a sphere in the
              RGB-space centered on nearcolor are displayed.

       -distance howfar
              defines how close colors have to be to nearcolor to be displayed.  This option sets
              the  radius of the sphere used by the -near option.  The scale is such that the RGB
              cube is 256 units on a side.  The default is 64.

ACTIONS

       set-foreground([color])
              Set the foreground color of the sample region.  If no color is provided, the  color
              is taken from the border color of the widget where the action occurred.

       set-background([color])
              Same as set-foreground() but sets the background color.

       quit() Exit xcolors.

RESOURCES

       Xcolors  has  a  few  top-level  application  resources that allow customizations that are
       specific to xcolors.

       startColor (classStartColor)
              See the -start option.

       rgbFile (classRgbFile)
              See the -rgbfile option.

       nearColor (classNearColor)
              See the -near option.

       nearDistance (classNearDistance)
              See the -distance option.

WIDGET HIERARCHY

       Knowing the name and position in the hierarchy of each widget is  useful  when  specifying
       resources for them.  In the chart below, the class and name of each widget is given.

       Xcolors xcolors
            Paned panes
                 AsciiText sample
                 Viewport viewport
                      Box colors
                           Label colorname
                           Label colorname
                           .
                           .
                           .

FILES

       /etc/X11/rgb.txt
              X color names and values.

BUGS

       Assumes that all names for the same color are consecutive in the rgb.txt file.

       Because  xcolors cannot read the server's color name database, the color names it uses may
       not match those in the server.  This is most likely to happen if xcolors  is  run  from  a
       remote host.

       The program would be faster if it used gadgets instead of widgets for the color spots.

AUTHOR

       Stephen Gildea, MIT X Consortium