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

NAME

6       im_lrmerge,    im_tbmerge,   im_lrsmerge,   im_tbsmerge,   im_lrmergeb,
7       im_tbmergeb - merges two images with a given dx and dy
8

SYNOPSIS

10       #include <vips/vips.h>
11
12       int im_lrmerge( ref, sec, out, dx, dy, mwidth )
13       IMAGE *ref, *sec, *out;
14       int dx, dy;
15       int mwidth;
16
17       int im_tbmerge( ref, sec, out, dx, dy, mwidth )
18       IMAGE *ref, *sec, *out;
19       int dx, dy;
20       int mwidth;
21
22

DESCRIPTION

24       im_lrmerge() and im_tbmerge()  merge  the  images  held  by  the  image
25       descriptors reference and secondary (ref and sec) according to the val‐
26       ues dx and dy. dx and dy give the displacement of sec relative to  ref.
27       The result is written on the image descriptor out.  The program carries
28       out a smooth merge using a raised cosine function.  Both work  for  any
29       image type, including LABPACK.
30
31       The  functions  treat pixels with the value zero as "transparent", that
32       is, zero pixels in the overlap area do not  contribute  to  the  merge.
33       This makes it possible to join non-rectangular images.
34
35       The  "mwidth"  parameter  limits  the  maximum width (or height) of the
36       blend area.  A value of "-1" means "unlimited". All other negative val‐
37       ues are errors.
38
39

RETURN VALUE

41       Both functions return 0 on success and -1 on error.
42

SEE ALSO

44       im_lrmosaic(3), im_tbmosaic(3), im_match_linear(3).
45
46
47
48                                  13 May 1991                    IM_LRMERGE(3)
Impressum