Method

VipsImagemosaic1

Declaration [src] 

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

Description [src]

Optional arguments:

  • search: search to improve tie-points
  • hwindow: half window size
  • harea: half search size
  • interpolate: interpolate pixels with this
  • mblend: maximum blend size

This operation joins two images top-bottom (with sec on the right) or left-right (with sec at the bottom) given an approximate pair of tie-points. sec is scaled and rotated as necessary before the join.

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

mblend limits the maximum size of the blend area. A value of “-1” means “unlimited”. The two images are blended with a raised cosine.

Pixels with all bands equal to zero are “transparent”, that is, zero pixels in the overlap area do not contribute to the merge. This makes it possible to join non-rectangular images.

If the number of bands differs, one of the images must have one band. In this case, an n-band image is formed from the one-band image by joining n copies of the one-band image together, and then the two n-band images are operated upon.

The two input images are cast up to the smallest common type (see table Smallest common format in arithmetic).

See also: vips_merge(), vips_insert(), vips_globalbalance().

This method is not directly available to language bindings.

Parameters

sec VipsImage
 

Secondary image.
 The data is owned by the caller of the function.
out VipsImage
 

Output image.
 The data is owned by the caller of the function.
direction VipsDirection
 

Horizontal or vertical join.
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.
...
 

NULL-terminated list of optional named arguments.

Return value

Returns: int
 

0 on success, -1 on error.