34 lines
970 B
Groff
34 lines
970 B
Groff
.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
|