Man Linux: Main Page and Category List

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(3), im_lrmerge(3), im_insert(3)

COPYRIGHT

       K. Martinez, N. Dessipris,

AUTHOR

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

                                 25 April 1991                         JOIN(3)