.TH IM_INSERT 3 "11 April 1990"
.SH NAME
im_insert \- insert one image into another
.SH SYNOPSIS
#include <vips/vips.h>

int im_insert(in, ins, out, x, y)
.br
IMAGE *in, *insub, *out;
.br
int x, y;
.SH DESCRIPTION
im_insert()
inserts one image into another. ins is inserted into image in at
position x, y relative to the top left hand corner of in. out is made large
enough to hold all of both in and ins. Any areas of out not coming from
either in or ins are set to black (binary 0). If ins overlaps in,
ins
will appear on top of in. Both images must have the same number of
bands and the same BandFmt.
.SH RETURN VALUE
The function returns 0 on success and -1 on error.
.SH SEE\ ALSO
im_extract(3), im_lrjoin(3), im_lrmerge(3)
.SH COPYRIGHT
.br
J. Cupitt,
.SH AUTHOR
J. Cupitt \- 11/04/1990