xcolors1

Usage

Overview

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.

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.