im_bandjoin(3)

im_bandjoin3

Join two or more images

Usage

#include <vips/vips.h>

int im_bandjoin(im1, im2, imout)
IMAGE *im1, *im2, *imout;

int im_gbandjoin(imarray, imout, no)
IMAGE *imarray[], *imout;
int no;

Overview

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.

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.

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.

Return value

The functions returns 0 on success and -1 on error.

Releases

Unchanged in 4 releases since Debian 3.1 (Sarge).

  1. 3.1–6.0

Author

J. Cupitt, N. Dessipris - 25/04/1991

From libvips-dev 7.20.7-1+b3 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.