
vnormal(1)                   Khoros                    vnormal(1)

PROGRAM
     vnormal - Normalize an image, forcing the pixel values to
     lie within a specified range.

SYNTAX
     vnormal

     -i             input image filename

     -o             output image filename

     -n             specifies normalization factor

     [-V]           Gives the version for vnormal

     [-U]           Gives the usage for vnormal

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vnormal computes that scale factor required to force the
     most positive pixel value in an image to be equal to the
     specified normalization target value, and then performs the
     required scaling.

     This routine is really just a front-end for lvconvert(3).

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

     -o     type: outfile
            desc: output image filename

     -n     type: float
            desc: specifies normalization factor

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vnormal -i input.image -o output.image -n 10

     This scales all of the pixels in input.image so that the
     most positive pixel is equal to 10.  All pixels are multi-
     plied by the same factor to accomplish this.  The result in
     stored in output.image.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3) vconvert(1),
     lvconvert(3)

RESTRICTIONS
     vnormal will not operate on transform input files.

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

Khoros                    Release: 1.0                          1

