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)
Check Out this Related Man Page
palette(3) User Contributed Perl Documentation palette(3)NAME
setPalette, bisque - Modify the Tk color palette
SYNOPSIS
$widget->setPalette(background)
$widget->setPalette(name=>value?,name=>value ...?)
$widget->bisque
DESCRIPTION
The setPalette method changes the color scheme for Tk. It does this by modifying the colors of existing widgets and by changing the option
database so that future widgets will use the new color scheme. If setPalette is invoked with a single argument, the argument is the name
of a color to use as the normal background color; setPalette will compute a complete color palette from this background color.
Alternatively, the arguments to setPalette may consist of any number of name-value pairs, where the first argument of the pair is the name
of an option in the Tk option database and the second argument is the new value to use for that option. The following database names are
currently supported:
activeBackground foreground selectColor
activeForeground highlightBackground selectBackground
background highlightColor selectForeground
disabledForeground insertBackground troughColor
setPalette tries to compute reasonable defaults for any options that you don't specify. You can specify options other than the above ones
and Tk will change those options on widgets as well. This feature may be useful if you are using custom widgets with additional color
options.
Once it has computed the new value to use for each of the color options, setPalette scans the widget hierarchy to modify the options of all
existing widgets. For each widget, it checks to see if any of the above options is defined for the widget. If so, and if the option's
current value is the default, then the value is changed; if the option has a value other than the default, setPalette will not change it.
The default for an option is the one provided by the widget (($w->configure('option'))[3]) unless setPalette has been run previously, in
which case it is the value specified in the previous invocation of setPalette.
After modifying all the widgets in the application, setPalette adds options to the option database to change the defaults for widgets
created in the future. The new options are added at priority widgetDefault, so they will be overridden by options from the .Xdefaults file
or options specified on the command-line that creates a widget.
The method bisque is provided for backward compatibility: it restores the application's colors to the light brown (``bisque'') color scheme
used in Tk 3.6 and earlier versions.
BUGS
The use of option database names rather than the configure names is understandable given the mechanism (copied from Tcl/Tk), but is
potentially confusing.
The interpolation of different 'shades' of color used for 3D effects in 'RGB' space can lead to undesirable changes in 'hue'.
Interpolation in 'HSV' (as used in Tk::ColorEditor) would be more robust and X11R5's color support probably even more so.
SEE ALSO
Tk::options
KEYWORDS
bisque, color, palette
perl v5.12.1 2007-05-05 palette(3)