Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 com-
     mand 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 de-
	    fault is 64.

ACTIONS
     set-foreground([color])
	    Set  the foreground color of the sample region.  If no color is pro-
	    vided, 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
     /usr/X11/lib/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, X Consortium

X Version 11			   6 June 1994			      XCOLORS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xcolors&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help