packages icon



 xdefmap(1)                     X Version 11                      xdefmap(1)
                                2nd April 96



 NAME
      xdefmap - enhanced X standard colormap utility

 SYNOPSIS
      xdefmap [-display host:dpy] options

 DESCRIPTION
      xdefmap is a tool similar to xstdcmap. It's main purpose is to install
      or delete standard colormaps. In contrast to xstdcmap, the main idea
      in this tool is to install maps that consist of read-only pixels into
      the default (pseudo) colormap of the display. It is also possible to
      arbitrary define the sizes of those maps.

      There is also an easy method to create XCMS-database files so that
      even applications that don't yet know anything of standard colormaps,
      can share the pixels.

      Additionaly there are some information functions contained in the
      program to give the color administrator :-) full control over it's
      maps.

 OPTIONS
      The option are therefore separated into the following subsections:

    INSTALLATION OF COLORMAPS
      -best       make the RGB_BEST_MAP

      -default    make the RGB_DEFAULT_MAP

      -gray       make the RGB_GRAY_MAP

      -red        make the RGB_RED_MAP

      -green      make the RGB_GREEN_MAP

      -blue       make the RGB_BLUE_MAP

      -s <n>      select the number of intensities for the desired map.
                  Allocates <n>x<n>x<n> colors, when best or default map are
                  selected.

      <r><g><b>   select a special colordistribution for best and default
                  maps, so that <r>x<g>x<b> colors have to be allocated

      -delete <map>
                  delete the selected map

    VISUALISATION OF THE COLORMAP
      -top, -right, bottom, -left
           create an information window with the current color palette at
           the desired edge of the screen.



                                    - 1 -           Formatted:  May 30, 2020






 xdefmap(1)                     X Version 11                      xdefmap(1)
                                2nd April 96



      -hide
           hide the information window

      -s <n>
           sets width or height of the information window to n pixels

      -set [<color1> <color2>]
           visualize unused colors in the information window by temporary
           setting the unallocated pixels

      -wait
           allocate all unused cells and keep them allocated to check the
           handling of other applications, when there are no more cells
           available

    XCMSDB SUPPORT
      -lookup
           looks up rgb-values for the colornames entered from stdin and
           creates a XCMSDB-file containing the closest entries found in the
           installed colormaps for those colors

      -parse [<rgb-file>]
           parses a file in the format of the rgb.txt-file (default:
           /usr/lib/X11/rgb.txt) and create a XCMSDB-file with all entries.

      -f <filename>
           write XCMSDB-file to <filename> instead of writing to stdout

    MAP FILES
      -stdmap <ppmfile>
           write colorinformation of installed colormaps into a file in
           ppm-format to be used as map-file in ppmquant(1)

      -map <ppmfile>
           write colorinformation of all shared colors into a file in ppm-
           format to be used as map-file in ppmquant(1)

    OTHERS
      -q   query information about the current usage of color cells and
           standard colormaps

      -v   be verbose, e.g. give information about pixels, that couldn't be
           allocated read-only when installing a map.

 EXAMPLES
      xdefmap -best 443 -v
           Install RGB_BEST_MAP with the size 4x4x3 = 48 colors and check,
           if there were many duplicates, so that read/write colors had to
           be used.





                                    - 2 -           Formatted:  May 30, 2020






 xdefmap(1)                     X Version 11                      xdefmap(1)
                                2nd April 96



      xdefmap -red 16
           install RGB_RED_MAP with 16 intensities

      xdefmap -best -parse > Xcms.txt
           transform the whole rgb.txt-file into a XCMSDB-database with
           alias names to get the closest color in the best map. The file
           can be used by letting the XCMSDB environment variable point to
           it. In that way all allocations with standard names (not rgb-
           names) will point into the standard map.

      xdefmap -set green red
           preset all unallocated entries with a colorbow from green to red.


 FILES
      /usr/lib/X11/rgb.txt

 SEE ALSO
      X(1), xstdcmap(1), XGetRGBColormaps(3), ppm(1), ppmquant(1),
      flying(6:-)

 BUGS
      The program is currently only designed for displays with an pseudo-
      color default visual with 256 colors.

      Installing standard colormaps in separate colormaps is not handled.

      There is a discrepancy between the defininition of gray-maps (where
      only reds should be used) and the implementation in xstdcmap. Since
      xstdcmap approach helps the application (and ImageMagick is the only
      package that I currently have to test it) I also implemented the
      xstdcmap way, but another option might be a better way.

      As a special feature, BEST and DEFAULT map can share their pixels, if
      they are defined with the same sizes. This colormap twin can not
      correctly be deleted by xstdcmap, since only one of the 2 maps really
      has the colors reserved.


 COPYRIGHT
      Copyright 1995, Helmut Hoenig, Heiligenhaus/Bad Camberg

      email (for any comments):
              Helmut.Hoenig@hub.de

      smail (for gifts):
              Helmut Hoenig
              Hopfenstrasse 8a
              65520 Bad Camberg
              GERMANY




                                    - 3 -           Formatted:  May 30, 2020






 xdefmap(1)                     X Version 11                      xdefmap(1)
                                2nd April 96



      Permission to use, copy, modify, and distribute this software for any
      purpose and without fee is hereby granted, provided that the above
      copyright notice appear in all copies.



















































                                    - 4 -           Formatted:  May 30, 2020