int
lvcast1(xvimage **images, int image_num, int up_type)
none
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. This routine calls lvconvert to do the actual up convert/cast of the image data.
The inputs to lvcast1 include:
xvimage *images[]
This is an array containing pointers to all of the images that are to be upcast. There is no limit on the number of images to convert.
int image_num
This is the number of pointers to images. That is, the size of *images[].
int up_type
This is the optional target data type. The target data type is specified by passing in the integer representing the desired VIFF data type. If auto upconvert is to be used, then passing in the value "-1" will default to finding the highest data type of the input images and upcasting the remaining images to this data type. lvcast1 will return a 1 upon success and a 0 upon failure.
none
none
$MMACH/objects/library/lmmach/src/lvcast1.c