MMACH commands


PROGRAM NAME

vcast1 - Upcast Images to the Highest Input Data Type

DESCRIPTION

vcast1 This is a modified version of Khoros' vcast. Scaling and Normalization are turned off, so that BIT to BYTE_1 conversion yields pixel values of 0 or 255 on the BYTE image. 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 vconvert. In trying to preserve the integrity of the data, vcast1 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}
-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}
-t
type: string toggle
desc: Select data type [default = Auto Upcast to Highest Input Data Type]
default: byte
allowed values:

EXAMPLES

vcast1 -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).

vcast1 -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

vconvert(1)

RESTRICTIONS

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

REFERENCES

COPYRIGHT

Copyright (C) 1993-1997 Junior Barrera, Roberto Lotufo. All rights reserved.