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:
- byte (choose byte data type),
- int (choose integer data type),
- complex (choose complex data type),
- short (choose short data type),
- float (choose float data type),
- or double (choose double data type)
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.