Method

VipsImageinsert

Declaration [src]

int
vips_insert (
  VipsImage* main,
  VipsImage* sub,
  VipsImage** out,
  int x,
  int y,
  ...
)

Description [src]

Optional arguments:

expand: expand output to hold whole of both images
background: colour for new pixels

Insert sub into main at position x, y.

Normally out shows the whole of main. If expand is TRUE then out is made large enough to hold all of main and sub. Any areas of out not coming from either main or sub are set to background (default 0).

If sub overlaps main, sub will appear on top of main.

If the number of bands differs, one of the images must have one band. In this case, an n-band image is formed from the one-band image by joining n copies of the one-band image together, and then the two n-band images are operated upon.

The two input images are cast up to the smallest common type (see table Smallest common format in arithmetic).

See also: vips_join(), vips_embed(), vips_extract_area().

This method is not directly available to language bindings.

Parameters

`sub`	`VipsImage`
	Small image.
	The data is owned by the caller of the function.
`out`	`VipsImage`
	Output image.
	The argument will be set by the function.
	The instance takes ownership of the data, and is responsible for freeing it.
`x`	`int`
	Left position of `sub`.
`y`	`int`
	Top position of `sub`.
`...`
	`NULL`-terminated list of optional named arguments.

Return value

Returns:	`int`
	0 on success, -1 on error.