
vheq(1)                      Khoros                       vheq(1)

PROGRAM
     vheq - Performs histogram equalization of a BYTE grey-level
     image.

SYNTAX
     vheq

     -i             input image

     -o             resulting output image

     [-p]           invert image

     [-V]           Gives the version for vheq

     [-U]           Gives the usage for vheq

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vheq performs a histogram equalization of the grey levels in
     a BYTE image.  Histogram equalization is often useful in
     improving the appearance of an image that has poor contrast.

     The output image can be inverted using the -p photonegative
     argument.  This is useful when looking for faint features on
     a dark background, such as is often done with astronomical
     images.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -p     type: boolean
            desc: invert image
            default: false

EXAMPLES
     vheq -i moon.xv -o moon.heq.xv -p 1

     will histogram equalize the image "moon.xv" and produce a
     photonegative output of that result in "moon.heq.xv".

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvheq(3)
     vhstr(1)

RESTRICTIONS
     vheq operates only on BYTE images.

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

Khoros                    Release: 1.0                          1

