RETRO commands


PROGRAM NAME

vcast - Upconvert All Inputs to the Highest Input Data Type (K1)

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 indicating 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 kconvert. In trying 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
default: {none}
-i4
type: infile
desc: input image 4
default: {none}
-i5
type: infile
desc: input image 5
default: {none}
-t
type: string toggle
desc: Select data type [default = Auto Upcast to Highest Input Data Type]
default: byte
allowed values:
-o3
type: outfile
desc: output image 3
default: {none}
-o4
type: outfile
desc: output image 4
default: {none}
-o5
type: outfile
desc: output image 5
default: {none}

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

kconvert

RESTRICTIONS

vcast only scales the input data by 1, and will only upconvert the data.

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.