Sophie

Sophie

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

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_RANK(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_rank, im_rank_raw - rank filter  
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include &lt;vips/vips.h&gt; 
<p> int
im_rank(in, out, xsize, ysize, n) <br>
IMAGE *in, *out; <br>
int xsize, ysize, n; 
<p> int im_rank_raw(in, out, xsize, ysize, n) <br>
IMAGE *in, *out; <br>
int xsize, ysize, n; 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<b>im_rank()</b> does rank filtering on an image.
A window of size xsize by ysize is passed over the image. At each position,
the pixels inside the window are sorted into ascending order and the pixel
at the nth position is output. n numbers from 0. 
<p> It works for any non-complex
image type, with any number of bands.  The input is expanded by copying
edge pixels before performing the operation so that the output image has
the same size as the input. Edge pixels in the output image are therefore
only approximate. 
<p> <b>im_rank_raw()</b> works just as im_rank(), but does not expand
the input. 
<h2><a name='sect3' href='#toc3'>Examples</a></h2>
For a median filter with mask size m (3 for 3x3, 5 for
5x5, etc.) use 
<p>    im_rank( in, out, m, m, m * m / 2 );<br>
 
<p> The special cases n == 0 and n == m * m - 1 are useful dilate and expand
 operators. 
<p> 
<h2><a name='sect4' href='#toc4'>Return Value</a></h2>
The function returns 0 on success and -1 on error.

<h2><a name='sect5' href='#toc5'>See Also</a></h2>
<a href='im_conv.3.html'>im_conv(3)</a>
, <a href='im_fastcor.3.html'>im_fastcor(3)</a>
. 
<h2><a name='sect6' href='#toc6'>Copyright</a></h2>
1989-1996 The National Gallery
and Birkbeck College <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'>Examples</a></li>
<li><a name='toc4' href='#sect4'>Return Value</a></li>
<li><a name='toc5' href='#sect5'>See Also</a></li>
<li><a name='toc6' href='#sect6'>Copyright</a></li>
</ul>
</body>
</html>