
vclip(1)                     Khoros                      vclip(1)

PROGRAM
     vclip - Clip the range of grey level values

SYNTAX
     vclip

     -i             input image

     -o             output image

     [-l]           lower limit

     [-u]           upper limit

     [-V]           Gives the version for vclip

     [-U]           Gives the usage for vclip

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vclip is used to limit the range of values that grey levels
     may occupy.  Values above the upper limit are set equal to
     the upper limit. Values below the lower limit are set equal
     to the lower value.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: output image

OPTIONAL ARGUMENTS
     -l     type: float
            desc: lower limit
            default: 0
            bounds: no range checking

     -u     type: float
            desc: upper limit
            default: 0
            bounds: no range checking

EXAMPLES
     vclip -i full_range.xv -u 123 -l 17 -o restricted_range.xv
     Limits the range of values in the input file full_range.xv
     to 17...123 and writes the result to restricted_range.xv.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvclip(3)
     vfloor(1)

RESTRICTIONS
     vclip does not work on BIT images. It works on the magnitude
     of COMPLEX images.

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

Khoros                    Release: 1.0                          1

