packages icon



 CNICE(1)                         cnice-0.6                         CNICE(1)
                                 29-Oct-1996



 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
      cnice is 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. cnice is 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 generated output 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 for tag 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 because some application allocated the color cell for
           private use (read-write).  Shared tells how many cells can be
           allocated read-only - sharing colors with other applications.
           Free tells how many celss are available for private (read-write)
           or shared (read-only) use.

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

      -v   turns off verbose mode.




                                    - 1 -         Formatted:  April 19, 2024






 CNICE(1)                         cnice-0.6                         CNICE(1)
                                 29-Oct-1996



      -f free
           sets up a threshold for the color allocation logic. If the number
           of free entries 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 should be considered far colors. The farest distance is
           1000. This is the distance between black and white. The default
           value is 70. Note that colors do not get allocated even if they
           are far if there are less than threshold 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 colors are found modify those to be allocatable/usable.
           The rebuilt command line is passed to the program.

      -s   is used only with - e option. It makes cnice picky about colors.
           Normally it accepts color names but 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 with the edited values back to standard
           output.

      -m   is used in conjunction with the - x option. 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



                                    - 2 -         Formatted:  April 19, 2024






 CNICE(1)                         cnice-0.6                         CNICE(1)
                                 29-Oct-1996



 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

 SEE ALSO
      X(1x), xrdb(1x)

 AUTHOR
      This program  was written by Gaspar Sinai <gsinai@gol.com>.








































                                    - 3 -         Formatted:  April 19, 2024