41 lines
1.3 KiB
Groff
41 lines
1.3 KiB
Groff
.TH IM_LRMERGE 3 "13 May 1991"
|
|
.SH NAME
|
|
im_lrmerge, im_tbmerge, im_lrsmerge, im_tbsmerge, im_lrmergeb, im_tbmergeb \- merges two images with a given dx and dy
|
|
.SH SYNOPSIS
|
|
#include <vips/vips.h>
|
|
|
|
int im_lrmerge( ref, sec, out, dx, dy, mwidth )
|
|
.br
|
|
IMAGE *ref, *sec, *out;
|
|
.br
|
|
int dx, dy;
|
|
.br
|
|
int mwidth;
|
|
|
|
int im_tbmerge( ref, sec, out, dx, dy, mwidth )
|
|
.br
|
|
IMAGE *ref, *sec, *out;
|
|
.br
|
|
int dx, dy;
|
|
.br
|
|
int mwidth;
|
|
|
|
.SH DESCRIPTION
|
|
im_lrmerge() and im_tbmerge() merge the images held by the image descriptors
|
|
reference and secondary (ref and sec) according to the values dx and dy. dx
|
|
and dy give the displacement of sec relative to ref. The result is written on
|
|
the image descriptor out. The program carries out a smooth merge using a
|
|
raised cosine function. Both work for any image type, including LABPACK.
|
|
|
|
The functions treat pixels with the value zero as "transparent", that is,
|
|
zero pixels in the overlap area do not contribute to the merge. This makes it
|
|
possible to join non-rectangular images.
|
|
|
|
The "mwidth" parameter limits the maximum width (or height) of the blend area.
|
|
A value of "-1" means "unlimited". All other negative values are errors.
|
|
|
|
.SH RETURN VALUE
|
|
Both functions return 0 on success and -1 on error.
|
|
.SH SEE ALSO
|
|
im_lrmosaic(3), im_tbmosaic(3), im_match_linear(3).
|