142 lines
2.5 KiB
Groff
142 lines
2.5 KiB
Groff
|
.TH RELATIONAL 3 "30 October 1992"
|
||
|
|
.SH NAME
|
||
|
|
im_equal, im_notequal, im_equalconst, im_equal_vec, im_notequalconst,
|
||
|
|
im_notequal_vec, im_less, im_lessconst, im_less_vec,
|
||
|
|
im_more, im_moreconst, im_more_vec, im_lesseq, im_lesseqconst, im_lesseq_vec,
|
||
|
|
im_moreeq,
|
||
|
|
im_moreeqconst, im_moreeq_vec \- relational tests on images.
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B #include <vips/vips.h>
|
||
|
|
|
||
|
|
.B int im_equal(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_equalconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_equal_vec(a, out, n, v)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.B int im_notequal(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_notequalconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_notequal_vec(a, out, n, v)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.B int im_less(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_lessconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_less_vec(a, out, n, v)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.B int im_more(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_moreconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_more_vec(a, out, n, v)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.B int im_lesseq(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_lesseqconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_lesseq_vec(a, out, n)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.B int im_moreeq(a, b, out)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *b, *out;
|
||
|
|
|
||
|
|
.B int im_moreeqconst(a, out, c)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B double c;
|
||
|
|
|
||
|
|
.B int im_moreeq_vec(a, out, n, v)
|
||
|
|
.br
|
||
|
|
.B IMAGE *a, *out;
|
||
|
|
.br
|
||
|
|
.B int n;
|
||
|
|
.br
|
||
|
|
.B double *v;
|
||
|
|
|
||
|
|
.SH DESCRIPTION
|
||
|
|
These functions perform a range of relational tests between images, or between
|
||
|
|
an image and a constant. Functions which take two images as arguments require
|
||
|
|
that the two images be the same size and have the same number of bands. They
|
||
|
|
can be of mixed type: you may compare an unsigned char image with a double
|
||
|
|
image.
|
||
|
|
|
||
|
|
All functions return an unsigned char image, with the same number of bands as
|
||
|
|
the input images, in which band elements have been set to 255 for true and 0
|
||
|
|
for false.
|
||
|
|
|
||
|
|
The logical functions (im_andimage(3), im_orimage(3), im_eorimage(3)) may be
|
||
|
|
used to combine boolean images to make more complex tests. The selection
|
||
|
|
function im_ifthenelse(3) may be used to take action on the result of a test.
|
||
|
|
|
||
|
|
.SH RETURN VALUE
|
||
|
|
All functions return 0 on success and -1 on error.
|
||
|
|
.SH SEE ALSO
|
||
|
|
im_ifthenelse(3), im_andimage(3).
|
||
|
|
.SH COPYRIGHT
|
||
|
|
National Gallery, 1992
|
||
|
|
.SH AUTHOR
|
||
|
|
J. Cupitt
|