
vlshift(1)                   Khoros                    vlshift(1)

PROGRAM
     vlshift - Left shift each pixel value in an image.

SYNTAX
     vlshift

     -i             input image

     -o             resulting output image

     -s             number of bit positions to shift

     [-m]           left shift operation masking image

     [-V]           Gives the version for vlshift

     [-U]           Gives the usage for vlshift

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vlshift performs a left shift on image data pixel by pixel
     using an operation gating image.  Zero's are shifted into
     the least significant bits.  In effect each pixel is multi-
     plied by two.

     The optional mask image must be of the same size and data
     type as the input image, and is used to gate the operation.
     A non-zero mask pixel enables the output pixel to contain
     the shifted value.  A zero mask pixel just transfers the
     value of the corresponding pixel in the input image to the
     output pixel without shifting it.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

     -s     type: integer
            desc: number of bit positions to shift

OPTIONAL ARGUMENTS
     -m     type: infile
            desc: left shift operation masking image

EXAMPLES
     vlshift -i input.image -o output.image -m mask.image -s 1

     This command performs a single left shift on each pixel
     value in input.image and stores them in output.image using
     the mask.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvlshift(3)

RESTRICTIONS
     vlshift will not operate on:
          Transforms, Float, Complex, and Bit
     data storage types.

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

Khoros                    Release: 1.0                          1

