---
name: "im_bandjoin"
section: "3"
platform: "linux"
package: "libvips-dev"
version: "7.20.7-1+b3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/im_bandjoin"
---

# im\_bandjoin(3)

join two or more images

## NAME

im\_bandjoin, im\_gbandjoin - join two or more images

## SYNOPSIS

**#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;**

## DESCRIPTION

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.

## SEE ALSO

[im\_lrjoin(3)](/im_lrjoin/3.md), [im\_lrmerge(3)](/im_lrmerge/3.md), [im\_insert(3)](/im_insert/3.md).

## COPYRIGHT

J. Cupitt, N. Dessipris

## AUTHOR

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