JOIN(3X)

NAME
im_lrjoin, im_tbjoin - join two images into one

SYNOPSIS
#include <vips/vips.h> int im_lrjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout ) int im_tbjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout )

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.

RETURN VALUE
The function returns 0 on success and -1 on error.

SEE ALSO
im_extract(3X), im_lrmerge(3X), im_insert(3X)

COPYRIGHT
K. Martinez, N. Dessipris,

AUTHOR
K. Martinez and N. Dessipris - 25/04/1991