libvips/man/im_remosaic.3
2007-08-31 13:01:42 +00:00

29 lines
831 B
Groff

.TH IM_REMOSAIC 3 "7 Nov 2001"
.SH NAME
im_remosaic \- rebuild a mosaic, substituting filenames
.SH SYNOPSIS
#include <vips/vips.h>
int im_remosaic( IMAGE *in, IMAGE *out,
.br
const char *old_str, const char *new_str )
.SH DESCRIPTION
.B im_remosaic(3)
works rather as im_global_balance(). It takes apart the mosaiced image in and
rebuilds it, substituting images.
Unlike
.B im_global_balance(3)
images are substituted based on their filenames. The rightmost occurence of
the string old_str is swapped for new_str, that file is opened, and that image
substituted for the old image.
It's convenient for multispectral images. You can mosaic one band, then use
that mosaic as a template for mosaicing the others automatically.
.SH RETURN VALUE
Functions return 0 on success and -1 on error.
.SH SEE ALSO
im_global_balance(3)