RETRO (vipl) functions
LIBRARY ROUTINE
lvcast - cast input images to highest image data type
LIBRARY CALL
int lvcast(
xvimage **images,
int image_num,
int up_type)
INPUT
- images - array of pointers to xvimage structures
- image_num - integer indicating the number of input images
- up_type - optional target data type. Pass in "-1" to select
auto upconvert.
OUTPUT
- images - array of pointers to resulting xvimage structures.
RETURN VALUE
TRUE (1) on success, FALSE (0) on failure
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 vconvert. In trying to
preserve the integrity of the data, vcast scales the data by 1.* This routine calls lvconvert to do the actual up convert/cast
of the image data.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$RETRO/objects/library/vipl/src/lvcast.c
SEE ALSO
vipl(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.