Sophie

Sophie

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

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_HEQ(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_heq, im_lhisteq, im_lhisteq_raw, im_hsp - process an image using
grey level transformations 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include &lt;vips/vips.h&gt; 
<p> int im_heq( in,
out, bandno ) <br>
IMAGE *in, *out; <br>
int bandno; 
<p> int im_lhisteq( in, out, xw, yw ) <br>
IMAGE *in, *out; <br>
int xw, yw; 
<p> int im_hsp( in, ref, out ) <br>
IMAGE *in, *ref, *out; 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<a href='im_heq.3.html'><b>im_heq(3)</b></a>
 histogram equalises the unsigned
char image held by the IMAGE descriptor in.  The result is written to the
IMAGE descriptor out. If bandno is -1 then all input bands are equalised
independently.  In all other cases the input image is equalised using the
histogram of bandno only. The latter processing produces better results.

<p> <a href='im_hsp.3.html'><b>im_hsp(3)</b></a>
 maps in to out with histogram specified by the ref.  All images
should be unsigned char.  Each band of the output image is specified according
to the distribution of grey levels of the reference image according to
<a href='im_histspec.3.html'>im_histspec(3)</a>
. 
<p> <a href='im_lhisteq.3.html'><b>im_lhisteq(3)</b></a>
 histogram equalises the one channel unsigned
char image pointed to by the Image descriptor in.  The result is written
to the IMAGE descriptor out. The histogram equalisation is based on a window
of size xw by yw centered at the current location of each input pixel. 

<p> In the manner of  <a href='im_conv.3.html'><b>im_conv(3)</b></a>
 the input image is expanded so that the output
image is the same size as the input. 
<p> <a href='im_lhisteq_raw.3.html'><b>im_lhisteq_raw(3)</b></a>
 is as above, but
does not expand the input. 
<p> 
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
All functions returns 0 on success
and -1 on error. 
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_histgr.3.html'>im_histgr(3)</a>
, <a href='im_histplot.3.html'>im_histplot(3)</a>
, <a href='im_histspec.3.html'>im_histspec(3)</a>
, <a href='im_lineprof.3.html'>im_lineprof(3)</a>
,
<a href='im_stdif.3.html'>im_stdif(3)</a>
. 
<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
1991--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'>Return Value</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Copyright</a></li>
</ul>
</body>
</html>