<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_MEASURE(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_measure - measure colour patches off images <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> #include <vips/vips.h> <p> DOUBLEMASK *im_measure(in, box, h, v, sel, nsel, name) <br> IMAGE *in; <br> IMAGE_BOX *box; <br> int h, v; <br> int *sel; <br> int nsel; <br> char *name; <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> Analyse a grid of colour patches, producing a DOUBLEMASK of averages. Pass an IMAGE, an IMAGE_BOX, the number of horizontal and vertical patches, an array giving the numbers of the patches to measure (patches are numbered left-to-right, top-to-bottom, starting with 1) and the name we should give the output mask. Return a DOUBLEMASK in which rows are patches and columns are bands. Only the central 50% of each patch is averaged. <p> Example: 6 band image of 4x2 block of colour patches. <br> +---+---+---+---+<br> | 1 | 2 | 3 | 4 |<br> +---+---+---+---+<br> | 5 | 6 | 7 | 8 |<br> +---+---+---+---+<br> <p> Then call im_measure( im, box, 4, 2, { 2, 4 }, 2, "fred" ) makes a mask "fred" which has 6 columns, two rows. The first row contains the averages for patch 2, the second for patch 4. <p> Output warnings: a warning is issued if the standard deviation of any patch is greater than 20% of the mean of that patch. <p> <h2><a name='sect3' href='#toc3'>Return Value</a></h2> NULL on error. <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_avg.3.html'>im_avg(3)</a> , <a href='im_deviate.3.html'>im_deviate(3)</a> , <a href='im_stats.3.html'>im_stats(3)</a> . <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> </ul> </body> </html>