
v1bgamut(1)                  Khoros                   v1bgamut(1)

PROGRAM
     v1bgamut - Compress grey levels of an image, produce new
     image with map

SYNTAX
     v1bgamut

     -i             input image filename

     -o             output image filename

     [-n]           specifies the number of levels to compress to

     [-r]           fraction of level splits based on 2-norm

     [-V]           Gives the version for v1bgamut

     [-U]           Gives the usage for v1bgamut

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called v1bgamut.ans
                    or file1

     [-a [file1]]   Uses v1bgamut.ans or file1 as the answer file

DESCRIPTION
     v1bgamut takes a 1 band generates a 1 band image with a map
     of the specified number of color levels that can be
     displayed using editimage.  The object is to make the
     displayable image look like the original even though the
     number of color levels is greatly restricted.

     The method employed is that used for vgamut(1), but only for
     one band.  All discussion pertinent to vgamut(1) is applica-
     ble here, except that the precision is fixed at 8 bits (i.e.
     full precision).

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image filename

     -o     type: outfile
            desc: output image filename

OPTIONAL ARGUMENTS
     -n     type: integer
            desc: specifies the number of levels to compress to
            default: 128
            bounds: 1 < [-n] < 256

     -r     type: float
            desc: fraction of level splits based on 2-norm
            default: 0.5
            bounds: 0.000000 < [-r] < 1.000000

EXAMPLES
     v1bgamut -i feath.xv -o compressed.xv -n 72

     Compresses the grey levels of image "feath.xv" and produces
     an image with a map containing 72 levels that approximates
     the original.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lv1bgamut(3)
     vgamut(1), vmsquish(1)

RESTRICTIONS
     v1bgamut works only on BYTE image with 1 band of data and no
     map.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

