| .TH DIVISION 3 "24 April 1991" |
| .SH NAME |
| im_divide \- divide two images |
| .SH SYNOPSIS |
| .B #include <vips/vips.h> |
| |
| .B int im_divide(in1, in2, out) |
| .br |
| .B IMAGE *in1, *in2, *out; |
| |
| .SH DESCRIPTION |
| .B 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), |
| .B im_divide(3) |
| calculates |
| ((x1*x2 + y1*y2)/(x2*x2 + y2*y2), (y1*x2 - x1*y2)/(x2*x2 + y2*y2)). |
| |
| .SH BUGS |
| The function does not check the result for over/underflow. |
| .SH RETURN VALUE |
| The function returns 0 on success and -1 on error. |
| .SH SEE\ ALSO |
| im_remainder(3), im_multiply(3), im_subtract(3), im_lintra(3), im_add(3). |
| .SH COPYRIGHT |
| National Gallery, 1995 |