Method

VipsImageembed

Declaration [src] 

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

Description [src]

Optional arguments:

  • extend: VipsExtend to generate the edge pixels (default: black)
  • background: VipsArrayDouble colour for edge pixels

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.

See also: vips_extract_area(), vips_insert().

This method is not directly available to language bindings.

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.
...
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.