MAN page from RedHat Other cnice-0.6-1.i386.rpm

CNICE

Section: User Commands (1)
Updated: 29-Oct-1996
Index

NAME

cnice - make cheap colors

SYNOPSIS

cnice-q[-v][-ca][-f free][-d distance][colors]
cnice [-s][-a][-f free][-d distance]-e command[args]
cnice-l[-a]
cnice-x[-m][-a][-f free][-d distance][files]

DESCRIPTION

cniceis an X application that queries the default colormap of the default screen. It can be used to print out the map or examine the color cells available for free use. cnice can also be used to pre-parse argument of a command for color names and find the color that takes the least resources. cniceis also able to parse X resource files for color names and modify them.Optionally it can add 3d shading color definition to the resource definitions for Motif.

OPTIONS

-q

puts cnice into query mode. In this mode it expects color names. The generatedoutput in verbose mode:

tag: input_color -> output_color cellnumber distance

for each color. In non-verbose mode it is

s/input_color/output_color/g

for colors that need to be changed. Possible values fortag are:

allocated:color need to be allocated

exact:exact color can be shared

approximate:approximate color can be shared

far:far color can be shared

The number of free cells are summerized at the last line in verbose mode.Used tells how many cells are not available for any use becausesome application allocated the color cell for private use (read-write).Shared tells how many cells can be allocated read-only - sharing colors with otherapplications.Freetells how many celss are available for private (read-write) or shared (read-only) use.

-c

is used with -qoption. It keeps cnice running continuously. Useful if you want to keep cells allocated.

-v

turnsoffverbose mode.

-f free

sets up a threshold for the color allocation logic. If the number of freeentries in the colormap are equal to or more than this number far colors get allocated. The default value is 20.

-d distance

sets up a distance for color chosing logic to determine which colors shouldbe considered far colors. The farest distance is 1000. This is the distance betweenblack and white. The default value is 70. Note that colors do not get allocatedeven if they are far if there are less thanthreshold number of free cells available.

-e command

This option should not be followed by any more options.cnice executes the command by preparsing its command line arguments and if any colorsare found modify those to be allocatable/usable. The rebuilt command lineis passed to the program.

-s

is used only with -eoption. It makes cnice picky about colors. Normally it accepts color namesbut with this option it will ignore those that do not start with #.

-l

lists all color cells and their availibility. The list format is:

cellno color free/used/shared

-x

reads standard input and interpret the lines as Resource Database values.cnice modifies the values that imply color names and write the whole input withthe edited values back to standard output.

-m

is used in conjunction with the -xoption. It generates extra output for shading colors for Motif.The extra resource name generated from background are

foreground

armColor

topShadowColor

bottomShadowColor

ENVIRONMENT

DISPLAY

FILE

/usr/lib/X11/rgb.txt

EXAMPLES

setenv DISPLAY unix:0.0

cnice -e xterm -bg darkgreen -fg peachpuff

cnice -x -m /usr/lib/X11/app-defaults/XMcd | xrdb -merge -

cnice -l

AUTHOR

This program was written by Gaspar Sinai <gsinaiAATTgol.com>.

This document was created byman2html,using the manual pages.