im_insert(3)

im_insert3

Insert one image into another

Usage

#include <vips/vips.h>

int im_insert(in, ins, out, x, y)
IMAGE *in, *insub, *out;
int x, y;

Overview

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.

Return value

The function 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 - 11/04/1990

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