Method

VipsImagematch

Declaration [src]

int
vips_match (
  VipsImage* ref,
  VipsImage* sec,
  VipsImage** out,
  int xr1,
  int yr1,
  int xs1,
  int ys1,
  int xr2,
  int yr2,
  int xs2,
  int ys2,
  ...
)

Description [src]

Scale, rotate and translate sec so that the tie-points line up.

If search is TRUE, before performing the transformation, the tie-points are improved by searching an area of sec of size harea for a match of size hwindow to ref.

This function will only work well for small rotates and scales.

::: tip “Optional arguments” * search: gboolean, search to improve tie-points * hwindow: gint, half window size * harea: gint, half search size * interpolate: VipsInterpolate, interpolate pixels with this.

Parameters

sec VipsImage
 

Secondary image.

 The data is owned by the caller of the function.
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.
xr1 int
 

First reference tie-point.

yr1 int
 

First reference tie-point.

xs1 int
 

First secondary tie-point.

ys1 int
 

First secondary tie-point.

xr2 int
 

Second reference tie-point.

yr2 int
 

Second reference tie-point.

xs2 int
 

Second secondary tie-point.

ys2 int
 

Second secondary tie-point.

... none
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.