Method

VipsImageembed

Declaration [src]

int
vips_embed (
  VipsImage* in,
  VipsImage** out,
  int x,
  int y,
  int width,
  int height,
  ...
)

Description [src]

The opposite of vips_extract_area(): embed in within an image of size width by height at position x, y.

extend controls what appears in the new pels, see VipsExtend.

::: tip “Optional arguments” * extend: VipsExtend to generate the edge pixels (default: VipsExtend) * background: VipsArrayDouble colour for edge pixels

::: seealso vips_extract_area(), vips_insert().

Parameters

`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`
	Place `in` at this x position in `out`.
`y`	`int`
	Place `in` at this y position in `out`.
`width`	`int`
	`out` should be this many pixels across.
`height`	`int`
	`out` should be this many pixels down.
`...`	`none`
	`NULL`-terminated list of optional named arguments.

Return value

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