| .TH IM_BANDJOIN 3 "28 June 1990" |
| .SH NAME |
| im_bandjoin, im_gbandjoin \- join two or more images |
| .SH SYNOPSIS |
| .B #include <vips/vips.h> |
| |
| .B int im_bandjoin(im1, im2, imout) |
| .br |
| .B IMAGE *im1, *im2, *imout; |
| |
| .B int im_gbandjoin(imarray, imout, no) |
| .br |
| .B IMAGE *imarray[], *imout; |
| .br |
| .B int no; |
| .SH DESCRIPTION |
| These function perform a band-wise join of two or more images. Input |
| images should be of the same type and should have the same sizes. |
| |
| .B im_bandjoin() |
| performs a band-wise join of two images. If the two images |
| have n and m bands respectively, then the output image will have n+m |
| bands, with the first n coming from the first image and the last m |
| from the second. |
| |
| .B im_gbandjoin() |
| performs a generalised band-wise join of no images. |
| Input images can have any number of bands; for instance if imarray[0] has j |
| bands, imarray[1] has k bands, ...., imarray[no-1] has z bands, output |
| has j+k+...+z bands. |
| .SH RETURN VALUE |
| The functions returns 0 on success and -1 on error. |
| .SH SEE\ ALSO |
| im_lrjoin(3), im_lrmerge(3), im_insert(3). |
| .SH COPYRIGHT |
| .br |
| J. Cupitt, N. Dessipris |
| .SH AUTHOR |
| J. Cupitt, N. Dessipris \- 25/04/1991 |