
vcast(1)                     Khoros                      vcast(1)

PROGRAM
     vcast - Upconvert all images to the highest input image data
     type.

SYNTAX
     vcast

     -i1            input image #1

     -i2            input image #2

     -o1            output image #1

     -o2            output image #2

     [-i3]          input image #3

     [-i4]          input image #4

     [-i5]          input image #5

     [-o3]          output image #3

     [-o4]          output image #4

     [-o5]          output image #5

     [-t]           Select data type [default = Auto Upcast to
                    Highest Input Data Type]:
                     'byte' (choose byte data type),
                     'short' (choose short data type),
                     'int' (choose integer data type),
                     'float' (choose float data type),
                     'complex' (choose complex data type),
                      or 'double' (choose double data type)
                       [default = byte]

     [-V]           Gives the version for vcast

     [-U]           Gives the usage for vcast

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vcast will upconvert or upcast each input image to the
     highest input image data type.  Optionally, the user may
     elect to upcast all images to a specified data type, as long
     as it is a data type that is equal to or greater than the
     highest data type of the input images.  If the user tries to
     select a data type that is lower than the highest data type
     of the input images, an error message will be produced indi-
     cating that down casting is not allowed.

     There are no restrictions as to the input image data types.
     The data types can range from BIT to DOUBLE.  The input
     images may contain any combination of sizes or number of
     data bands.  All map information from each input image is
     transferred to the corresponding output image.

     Note that when converting from type BIT to BYTE, the output
     values will be 0 or 1.  This is different from the results
     one would obtain using the defaults with vconvert.  In try-
     ing to preserve the integrity of the data, vcast scales the
     data by 1.

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: input image #1

     -i2    type: infile
            desc: input image #2

     -o1    type: outfile
            desc: output image #1

     -o2    type: outfile
            desc: output image #2

OPTIONAL ARGUMENTS
     -i3    type: infile
            desc: input image #3

     -i4    type: infile
            desc: input image #4

     -i5    type: infile
            desc: input image #5

     -o3    type: outfile
            desc: output image #3

     -o4    type: outfile
            desc: output image #4

     -o5    type: outfile
            desc: output image #5

     -t     type: string
            desc: Select data type [default = Auto Upcast to
            Highest Input Data Type]
            allowed values:
             'byte' (choose byte data type),
             'short' (choose short data type),
             'int' (choose integer data type),
             'float' (choose float data type),
             'complex' (choose complex data type),
              or 'double' (choose double data type)

EXAMPLES
     vcast -i1 image.bit -i2 image.float -o1 image1 -o2 image2

     converts both input images to data type FLOAT.  The optional
     data type argument was not selected, so auto convert was
     used to cast both images to the highest data type of the
     input images (in this case FLOAT).

     vcast -i1 image.bit -i2 image.byte -i3 image.short -o1 img1
     -o2 img2 -o3 img3 -t float

     converts each input image to data type FLOAT.  The optional
     data type argument was used to upcast all input images to
     data type FLOAT.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvcast(3) vcon-
     vert(1)

RESTRICTIONS
     vcast only scales the input data by 1, and will only upcon-
     vert the data.

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

Khoros                    Release: 1.0                          1

