Sophie

Sophie

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

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_FWFFT(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_fwfft, im_invfft, im_invfftr - forward and inverse fft on an image

<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>#include &lt;vips/vips.h&gt;</b> 
<p> <b>int im_fwfft(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_invfft(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> <b>int im_invfftr(in, out)</b> <br>
<b>IMAGE *in, *out;</b> 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<b>im_fwfft()</b> performs a forward fast Fourier
Transform on the image held by the image descriptor in and writes the result
to the image descriptor out. The image can be in any format and have any
number of bands. The output is always complex. 
<p> If VIPS has been built with
support for libfftw, a high-speed FFT library, then fftwnd_one() is used
to compute the transform. This produces a double precision complex result.
The first transformation at a particular image size will be very slow as
libfftw optimises itself for your machine, but subsequent transforms of
images of that size are extremely fast. Unfortunately, libfftw does not
have good out-of-memory behaviour. If you try to transform a very large image,
your program will exit abruptly. 
<p> If VIPS has not been built with libfftw
support, VIPS uses its own fft routines. These are rather slow, are single
precision only, and can only transform images whose sides are a power of
two. 
<p> <b>im_invfft()</b> performs the reverse transform. The input image must be
complex, the output is always complex. The image may have any number of
bands. 
<p> Again, if libfftw was present when VIPS was compiled, that library
is used to calculate the transform. 
<p> <b>im_invfftr()</b> performs the reverse transform.
The input image must be complex, the output is always real. The image may
have any number of bands. It is about 2 x faster than <b>im_invfft().</b> 
<p> Again,
if libfftw was present when VIPS was compiled, that library is used to
calculate the transform. 
<p> 
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
The function returns 0 on success
and -1 on error. 
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_rotquad.3.html'>im_rotquad(3)</a>
, <a href='im_c2ps.3.html'>im_c2ps(3)</a>
, <a href='im_scaleps.3.html'>im_scaleps(3)</a>
, <a href='im_disp_ps.3.html'>im_disp_ps(3)</a>
.

<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
1995, 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>