
vscale(1)                    Khoros                     vscale(1)

PROGRAM
     vscale - Multiply (scale) an image by a constant.

SYNTAX
     vscale

     -i             input image

     -o             resulting output image

     -s             multiply image by scale factor

     [-V]           Gives the version for vscale

     [-U]           Gives the usage for vscale

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vscale performs a simple scaling of the input image to
     obtain the output image. An input pixel is just multiplied
     by a constant and the assigned to the output, with max/min
     clipping if required.

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

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

     -s     type: float
            desc: multiply image by scale factor

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vscale -i input.image -o output.image -s 2

     This multiples each pixel in input.image by 2 and places the
     result in output.image.

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

RESTRICTIONS
     vscale will not operate on transform input files.

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

Khoros                    Release: 1.0                          1

