<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>IM_ITERATE(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_iterate - PIO input from image
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>#include <vips/vips.h></b>
<p> int im_iterate(
im, start_fn, scan_fn, stop_fn, a, b ) <br>
IMAGE *im; <br>
void *(*start_fn)(); <br>
int (*scan_fn)(); <br>
int (*stop_fn)(); <br>
void *a, *b;
<p> where, typically,
<p> void *start_fn( im, a, b ) <br>
IMAGE *im; <br>
void *a, *b;
<p> int scan_fn( or, seq, a, b ) <br>
REGION *or; <br>
void *seq; <br>
void *a, *b;
<p> int stop_fn( seq, a, b ) <br>
void *seq; <br>
void *a, *b;
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<a href='im_iterate.3.html'>im_iterate(3)</a>
is used for PIO image input. See ‘VIPS
Library Programmers’ guide,’ in the accompanying documentation, for an introduction
to this function.
<p> <a href='im_iterate.3.html'>im_iterate(3)</a>
makes one or more regions on im, and starts
one or more sequences running over the image. <a href='im_iterate.3.html'>im_iterate(3)</a>
guarantees that
<p> - scan_fn() will see each of the pels in im exactly once<br>
- start_fn() and stop_fn() are both exclusive<br>
<p> See the guide, the man page for <a href='im_generate.3.html'>im_generate(3)</a>
, and the source to <a href='im_deviate.3.html'>im_deviate(3)</a>
for examples.
<p> On machines with SVR4 threads and several CPUs, <a href='im_generate.3.html'>im_generate(3)</a>
and <a href='im_iterate.3.html'>im_iterate(3)</a>
automatically parallelise programs. You can set the desired
concurrency level with the environment variable IM_CONCURRENCY, for example
<p> example% setenv IM_CONCURRENCY 2<br>
example% stats fred.v <br>
<p> will run stats with enough concurrency to keep 2 CPUs fully occupied.
If IM_CONCURRENCY is not set, then it defaults to 1.
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
All functions
return 0 on success and non-zero on error.
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_generate.3.html'>im_generate(3)</a>
.
<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
National
Gallery, 1993
<h2><a name='sect6' href='#toc6'>Author</a></h2>
J. Cupitt - 23/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'>Return Value</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Copyright</a></li>
<li><a name='toc6' href='#sect6'>Author</a></li>
</ul>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
c109337651527e96d7bb9adc83c5b18a
>
files
>
359
