<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>PREDICATES(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_region_create, im_region_free - region creation and destruction <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> REGION *im_region_create( im ) <br> IMAGE *im; <p> int im_region_free( reg ) <br> REGION *reg; <h2><a name='sect2' href='#toc2'>Description</a></h2> These functions create and destroy regions on images. Regions are used for PIO, see accompanying documentation. Regions have type <p> typedef struct {<br> Rect valid /* Area of im represented */<br> IMAGE *im; /* im we are defined on */<br> <p> ... more fields, all private and used for<br> ... housekeeping<br> } REGION;<br> <p> <a href='im_region_create.3.html'>im_region_create(3)</a> returns a pointer to a new region, or NULL on error. Regions are made blank, with no input or output possible. See <a href='im_prepare.3.html'>im_prepare(3)</a> , <a href='im_generate.3.html'>im_generate(3)</a> , <a href='im_start_one.3.html'>im_start_one(3)</a> and <a href='IM_REGION_ADDR.3.html'>IM_REGION_ADDR(3)</a> . <p> <a href='im_region_free.3.html'>im_region_free(3)</a> frees a region and any resources associated with that region. When an image is closed, all regions which have been created on that image are automatically freed. <h2><a name='sect3' href='#toc3'>Return Value</a></h2> All int-valued functions return zero on success and non-zero on error. <h2><a name='sect4' href='#toc4'>Copyright</a></h2> National Gallery, 1993 <h2><a name='sect5' href='#toc5'>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'>Copyright</a></li> <li><a name='toc5' href='#sect5'>Author</a></li> </ul> </body> </html>