1JOIN(3)                    Library Functions Manual                    JOIN(3)
2
3
4

NAME

6       im_lrjoin, im_tbjoin - join two images into one
7

SYNOPSIS

9       #include <vips/vips.h>
10
11       int im_lrjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout )
12
13       int im_tbjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout )
14

DESCRIPTION

16       These  functions  join  two image left-right or top-bottom.  Both input
17       images should have the same no of bands and the same  BandFmt.   Output
18       has the same no of bands and BandFmt as input.  Only the history of the
19       first image is kept by the output image.
20
21       im_lrjoin() joins two images held by image descriptors im1 and im2  and
22       writes  the  resultant  byte  image on the image descriptor imout.  The
23       number of the extracted channels are identical  for  all  images.   The
24       Xsize  of  imout  is the sum of the Xsizes of im1 and im2; the Ysize of
25       imout is the min of the Ysizes of im1 and im2.  When joining im1 is  on
26       the left side of imout and im2 is on the right side of imout.
27
28       im_tbjoin()  joins two images held by image descriptors im1 and im2 and
29       writes the resultant byte image on the  image  descriptor  imout.   The
30       number  of  the  extracted  channels are identical for all images.  The
31       Xsize of imout is the min of the Xsizes of im1 and im2;  the  Ysize  of
32       imout  is the sum of the Ysizes of im1 and im2.  When joining im1 is on
33       the top side of imout and im2 is on the bottom side of imout.
34
35

RETURN VALUE

37       The function returns 0 on success and -1 on error.
38

SEE ALSO

40       im_extract(3), im_lrmerge(3), im_insert(3)
41

43       K. Martinez, N. Dessipris,
44

AUTHOR

46       K. Martinez and N. Dessipris - 25/04/1991
47
48
49
50                                 25 April 1991                         JOIN(3)
Impressum