Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > 7faa4cd12598db7d59564e3dc9a0913c > files > 391

vips-7.18.2-1mdv2010.0.i586.rpm

<!-- 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 &lt;vips/vips.h&gt;

<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>