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 applicable 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.