| .TH JOIN 3 "25 April 1991" |
| .SH NAME |
| im_lrjoin, im_tbjoin \- join two images into one |
| .SH SYNOPSIS |
| #include <vips/vips.h> |
| |
| int im_lrjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout ) |
| |
| int im_tbjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout ) |
| .SH DESCRIPTION |
| These functions join two image left-right or top-bottom. Both input images |
| should have the same no of bands and the same BandFmt. Output has the same no |
| of bands and BandFmt as input. Only the history of the first image is kept by |
| the output image. |
| |
| im_lrjoin() joins two images held by image descriptors im1 and im2 and writes |
| the resultant byte image on the image descriptor imout. The number of the |
| extracted channels are identical for all images. The Xsize of imout is the |
| sum of the Xsizes of im1 and im2; the Ysize of imout is the min of the Ysizes |
| of im1 and im2. When joining im1 is on the left side of imout and im2 is on |
| the right side of imout. |
| |
| im_tbjoin() joins two images held by image descriptors im1 and im2 and writes |
| the resultant byte image on the image descriptor imout. The number of the |
| extracted channels are identical for all images. The Xsize of imout is the |
| min of the Xsizes of im1 and im2; the Ysize of imout is the sum of the Ysizes |
| of im1 and im2. When joining im1 is on the top side of imout and im2 is on |
| the bottom side of imout. |
| |
| .SH RETURN VALUE |
| The function returns 0 on success and -1 on error. |
| .SH SEE ALSO |
| im_extract(3), im_lrmerge(3), im_insert(3) |
| .SH COPYRIGHT |
| .br |
| K. Martinez, N. Dessipris, |
| .SH AUTHOR |
| K. Martinez and N. Dessipris \- 25/04/1991 |