Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > c109337651527e96d7bb9adc83c5b18a > files > 250

libvips-devel-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_EXPTRA(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_exp10tra, im_exptra, im_expntra, im_expntra_vec, im_log10tra, im_logtra,
 im_powtra, im_powtra_vec - logarithmic, exponential and power transform
of an image 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>#include &lt;vips/vips.h&gt;</b> 
<p> <b>int im_expntra(in, out, base)</b>
<br>
<b>IMAGE *in, *out;</b> <br>
<b>double base;</b> 
<p> <b>int im_expntra_vec(in, out, n, vec)</b> <br>
<b>IMAGE *in, *out;</b> <br>
<b>int n;</b> <br>
<b>double *vec;</b> 
<p> <b>int im_exp10tra(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_exptra(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_log10tra(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_logtra(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_powtra(in, out, exponent)</b> <br>
<b>IMAGE *in, *out;</b> <br>
<b>double exponent;</b> 
<p> <b>int im_powtra_vec(in, out, n, vec)</b> <br>
<b>IMAGE *in, *out;</b> <br>
<b>int n;</b> <br>
<b>double *vec;</b> 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
Each of the above functions maps in through a
log or anti-log  function of some sort and writes the result to out. The
size and number of bands are unchanged, the output type is float, unless
the input is double, in which case the output is double. Non-complex images
only! 
<p> <a href='im_expntra.3.html'><b>im_expntra(3)</b></a>
 transforms element x of input, to pow(base, x) in
output. It detects division by zero, setting those pixels to zero in the
output. Beware: it does this  silently! 
<p> <a href='im_expntra_vec.3.html'><b>im_expntra_vec(3)</b></a>
 works as im_expntra(),
but lets you specify a constant per band. 
<p> <a href='im_exp10tra.3.html'><b>im_exp10tra(3)</b></a>
 transforms element
x of input, to pow(10,0, x) in output. Internally, it is defined in terms
of im_expntra(). 
<p> <a href='im_exptra.3.html'><b>im_exptra(3)</b></a>
 transforms element x of input, to pow(e,
x) in output, where e is the mathematical constant. Internally, it is defined
in terms of im_expntra(). 
<p> <a href='im_log10tra.3.html'><b>im_log10tra(3)</b></a>
 transforms element x of input,
to log10tra(x) in output. 
<p> <a href='im_logtra.3.html'><b>im_logtra(3)</b></a>
 transforms element x of input, to
logtra(x) in output. 
<p> <a href='im_powtra.3.html'><b>im_powtra(3)</b></a>
 transforms element x of input, to pow(x,
exponent) in output. It detects division by zero, setting those pixels to
zero in the output. Beware: it does this silently! 
<p> <a href='im_powtra_vec.3.html'><b>im_powtra_vec(3)</b></a>
 works
as <a href='im_powtra.3.html'>im_powtra(3)</a>
, but lets you specify a constant per band. 
<p> 
<h2><a name='sect3' href='#toc3'>Bugs</a></h2>
None of
the functions checks for under/overflow. Overflow is very common for many
of these functions!  
<p> 
<h2><a name='sect4' href='#toc4'>Return Value</a></h2>
Each function returns 0 on success and
-1 on error. 
<h2><a name='sect5' href='#toc5'>See Also</a></h2>
<a href='im_add.3.html'>im_add(3)</a>
, <a href='im_multiply.3.html'>im_multiply(3)</a>
, <a href='im_subtract.3.html'>im_subtract(3)</a>
, <a href='im_lintra.3.html'>im_lintra(3)</a>
,
<a href='im_absim.3.html'>im_absim(3)</a>
, <a href='im_mean.3.html'>im_mean(3)</a>
, <a href='im_max.3.html'>im_max(3)</a>
. 
<h2><a name='sect6' href='#toc6'>Author</a></h2>
N. Dessipris - 24/04/1991 <br>
J. Cupitt (rewrite) - 21/7/93 <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'>Bugs</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'>Author</a></li>
</ul>
</body>
</html>