XCOLORS(1)						      General Commands Manual							XCOLORS(1)

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

X Version 11							  3 October 1991							XCOLORS(1)