1IM_EMBED(3)                Library Functions Manual                IM_EMBED(3)
2
3
4

NAME

6       im_embed - extract a portion of an image
7

SYNOPSIS

9       #include <vips/vips.h>
10
11       int im_embed( in, out, type, x, y, w, h )
12       IMAGE *in, *out;
13       int type;
14       int x, y, w, h;
15
16

DESCRIPTION

18       im_embed() embeds in within a larger image (size w by h), with in's top
19       left-hand corner at position (x,y) within the output image.  The  value
20       of type controls what appears in the new pels.
21
22        0 - black pels (all bytes 0)
23        1 - extend pels from image to edge
24        2 - tile pels from image
25        3 - mirror pels from image
26        4 - white pels (all bytes 255)
27
28       Works for any size image, any number of bands, any type. Works for LAB‐
29       PACK coded images too.
30
31

RETURN VALUE

33       The function returns 0 on success and -1 on error.
34

SEE ALSO

36       im_insert(3), im_extract(3), im_region_region(3), im_fill_copy(3).
37

39       National Gallery, 1995.
40

AUTHOR

42       J. Cupitt - 11/04/1995
43
44
45
46                                 11 April 1995                     IM_EMBED(3)
Impressum