RETRO (vipl) functions
LIBRARY ROUTINE
lvbandsp1 - extract single band images from one multiband image
LIBRARY CALL
int lvbandsp1(
xvimage *img,
xvimage **images,
char *img_file_name,
int mod_comment)
INPUT
- img - the input xvimage structure to extract bands from.
- images - a list of pointers to xvimage structures. The result
is passed in from a call to
creat_images_list(image->num_data_bands).
- img_file_name - a pointer to the name of the img file.
- mod_comment - this is a flag that if set to true modifies the
new image's comment field by appending the data
band number and the original file name from
which the new image was created.
OUTPUT
- images - returns a list of pointers to xvimage structures, the
new images containing only one data band are returned in this
structure.
RETURN VALUE
TRUE (1) on success, FALSE (0) on failure
DESCRIPTION
lvbandsprt extracts all bands from an image and creates
separate images from each band. The map is also carried along
with the new image, and the map scheme will become ONEPERBAND
regardless of the input image's map scheme. The comment field
of the new image will read the same as the comment field of
the input image, except it is append with the band number and
the filename from which the band was taken.
The arguments to lvbandsprt include:
NOTE: This library routine is common to both vbandspt1 and
vbandspt3, and is called by each routine to perform the data
band separation.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
1/18/91 - Added an error message trapping for input images
with only one band. C.Gage.
8/18/91 - Added a line of code to fix bug reported by Bengt
Martensson. Location data not being copied.
FILES
$RETRO/objects/library/vipl/src/lvbandsp1.c
SEE ALSO
vipl(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.