<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>RELATIONAL(3) manual page</title> </head> <body bgcolor='white'> <a href='#toc'>Table of Contents</a><p> <h2><a name='sect0' href='#toc0'>Name</a></h2> 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. <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> <b>int im_equal(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_equalconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_equal_vec(a, out, n, v)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <b>int im_notequal(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_notequalconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_notequal_vec(a, out, n, v)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <b>int im_less(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_lessconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_less_vec(a, out, n, v)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <b>int im_more(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_moreconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_more_vec(a, out, n, v)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <b>int im_lesseq(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_lesseqconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_lesseq_vec(a, out, n)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <b>int im_moreeq(a, b, out)</b> <br> <b>IMAGE *a, *b, *out;</b> <p> <b>int im_moreeqconst(a, out, c)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>double c;</b> <p> <b>int im_moreeq_vec(a, out, n, v)</b> <br> <b>IMAGE *a, *out;</b> <br> <b>int n;</b> <br> <b>double *v;</b> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> 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. <p> 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. <p> The logical functions (<a href='im_andimage.3.html'>im_andimage(3)</a> , <a href='im_orimage.3.html'>im_orimage(3)</a> , <a href='im_eorimage.3.html'>im_eorimage(3)</a> ) may be used to combine boolean images to make more complex tests. The selection function <a href='im_ifthenelse.3.html'>im_ifthenelse(3)</a> may be used to take action on the result of a test. <p> <h2><a name='sect3' href='#toc3'>Return Value</a></h2> All functions return 0 on success and -1 on error. <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_ifthenelse.3.html'>im_ifthenelse(3)</a> , <a href='im_andimage.3.html'>im_andimage(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> National Gallery, 1992 <h2><a name='sect6' href='#toc6'>Author</a></h2> J. Cupitt <p> <hr><p> <a name='toc'><b>Table of Contents</b></a><p> <ul> <li><a name='toc0' href='#sect0'>Name</a></li> <li><a name='toc1' href='#sect1'>Synopsis</a></li> <li><a name='toc2' href='#sect2'>Description</a></li> <li><a name='toc3' href='#sect3'>Return Value</a></li> <li><a name='toc4' href='#sect4'>See Also</a></li> <li><a name='toc5' href='#sect5'>Copyright</a></li> <li><a name='toc6' href='#sect6'>Author</a></li> </ul> </body> </html>