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 multiplied 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.