Man Linux: Main Page and Category List

NAME

       im_match_linear_search, im_match_linear - resample to make a match

SYNOPSIS

       #include <vips/vips.h>

       int
       im_match_linear( IMAGE *ref, IMAGE *sec, IMAGE *out,
          int xr1, int yr1, int xs1, int ys1,
          int xr2, int yr2, int xs2, int ys2 )

       int
       im_match_linear_search( IMAGE *ref, IMAGE *sec, IMAGE *out,
          int xr1, int yr1, int xs1, int ys1,
          int xr2, int yr2, int xs2, int ys2,
          int hwindowsize, int hsearchsize )

DESCRIPTION

       im_match_linear_search()  attempts  to  transform  sec to make it match
       ref. The transformation is linear, that is,  it  only  involves  scale,
       rotate and translate.

       im_match_linear_search()  requires  a  pair  of  tie  points to fix the
       parameters of its transformation. You should pick points as  far  apart
       as  possible to increase accuracy. im_match_linear_search() will search
       the area in the image around each tie point for a  good  fit,  so  your
       selection  of points need not be exact. WARNING! This searching process
       will fail for rotations of more than about 10 degrees or for scales  of
       more  than  about  10  percent.  The best you can hope for is < 1 pixel
       error, since the command does not attempt sub-pixel correlation.

       hwindowsize and hsearchsize set the size of the area to be searched: we
       recommend values of 5 and 14.

       The  output image is positioned and clipped so that you can immediately
       subtract it from orig to obtain pixel difference images.

       im_match_linear() works exactly as im_match_linear_search(),  but  does
       not  attempt  to  correlate  to correct your tie points. It can thus be
       used for any angle and any scale, but you must be far more  careful  in
       your selection.

SEE ALSO

       im_lrmosaic().

AUTHORS

       J.Ph.Laurent - 12/12/92
       J.Cupitt - 22/02/93

                                  13 May 1991                  MATCH_LINEAR(3)