Sophie

Sophie

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

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_CLOSE(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_close - close an image descriptor 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include &lt;vips/vips.h&gt; 
<p> int
im_close(image) <br>
IMAGE *image; 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<a href='im_close.3.html'>im_close(3)</a>
 frees all the resources attached to
the image descriptor. This may involve closing files, freeing memory buffers,
triggering close callback lists, unmapping files, freeing regions, and
so on. If all this succeeds, then the function returns zero. If something
goes wrong, the function returns non-zero and sets <a href='im_errormsg.3.html'>im_errormsg(3)</a>
. If <a href='im_close.3.html'>im_close(3)</a>

fails, the image descriptor is left in an undefined state. 
<p> In the case
that the image descriptor corresponds to a file opened by <a href='im_openout.3.html'>im_openout(3)</a>

that has been written to, the function sets an output description file
as follows:  If the output image filename is terminated with ".v",  the
string held by the Hist member of the image descriptor is copied to a corresponding
file ending with ".desc" in the same directory.  In all other cases, an output
.desc file is not created. 
<p> If a NULL pointer is passed to <a href='im_close.3.html'>im_close(3)</a>
, it
returns successfully immediately. 
<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'>Copyright</a></h2>
N. Dessipris, K. Martinez, J. Cupitt 
<h2><a name='sect5' href='#toc5'>See Also</a></h2>
<a href='im_mmapin.3.html'>im_mmapin(3)</a>
,
<a href='im_openin.3.html'>im_openin(3)</a>
, <a href='im_openout.3.html'>im_openout(3)</a>
, <a href='im_setbuf.3.html'>im_setbuf(3)</a>
, <a href='im_open.3.html'>im_open(3)</a>
, <a href='im_incheck.3.html'>im_incheck(3)</a>
, <a href='im_pincheck.3.html'>im_pincheck(3)</a>
.

<h2><a name='sect6' href='#toc6'>Author</a></h2>
N. Dessipris - 11/04/1990 <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'>Copyright</a></li>
<li><a name='toc5' href='#sect5'>See Also</a></li>
<li><a name='toc6' href='#sect6'>Author</a></li>
</ul>
</body>
</html>