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

OUTPUT

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.