**NAME**

im_divide - divide two images

**SYNOPSIS**

**#include** **<vips/vips.h>**
**int** **im_divide(in1,** **in2,** **out)**
**IMAGE** ***in1,** ***in2,** ***out;**

**DESCRIPTION**

**im_divide(3)** divides two images. The result is float except if one (or
both) input is double. In the latter case the result is double. If
either input is complex, the result is complex. If either input is
double complex, the output is double complex.
Input images in1 and in2 should have the same channels and the same
sizes, however they can be of different types.
For complex input pels (x1,y1) and (x2,y2), **im_divide(3)** calculates
((x1*x2 + y1*y2)/(x2*x2 + y2*y2), (y1*x2 - x1*y2)/(x2*x2 + y2*y2)).

**BUGS**

The function does not check the result for over/underflow.

**RETURN** **VALUE**

The function returns 0 on success and -1 on error.

**SEE ALSO**

im_remainder(3), im_multiply(3), im_subtract(3), im_lintra(3),
im_add(3).

**COPYRIGHT**

National Gallery, 1995
24 April 1991 DIVISION(3)