<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_EXTRACT(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_extract_areabands, im_extract_bands, im_extract_area - extract a portion of an image <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> int im_extract_areabands( IMAGE *in, IMAGE *out, <br> int left, int top, int width, int height, int band, int nbands )<br> <p> int im_extract_area( IMAGE *in, IMAGE *out, <br> int left, int top, int width, int height )<br> <p> int im_extract_bands( IMAGE *in, IMAGE *out, <br> int chsel, int nbands )<br> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_extract_areabands.3.html'><b>im_extract_areabands(3)</a> </b> extracts the rectangular portion of the image defined by <b>left, </b> <b>top, </b> <b>width,</b> and <b>height of image </b> <b>in </b> and writes the result to image <b>out. </b> The area must lie entirely within in the image. Selects the set of <b>nbands</b> bands starting at band number <b>band</b> (numbering bands from zero). <p> Works for any size image, any number of bands, any type. Works for LABPACK coded images too! But disallows band extraction in this case. <p> <a href='im_extract_area.3.html'><b>im_extract_area(3)</a> </b> is a convenience function which extracts an area from an image, leaving the bands the same. <p> <a href='im_extract_bands.3.html'><b>im_extract_bands(3)</a> </b> takes <b>nbands</b> out of an image, starting from band <b>band.</b> So, for example, nbands == 2, bands == 1 will form a two band image from an RGB image, where the two bands are the G and the B bands. <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_insert.3.html'>im_insert(3)</a> , <a href='im_lrjoin.3.html'>im_lrjoin(3)</a> , <a href='im_lrmerge.3.html'>im_lrmerge(3)</a> , <a href='im_stats.3.html'>im_stats(3)</a> , <a href='im_region_region.3.html'>im_region_region(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> J. Cupitt, <h2><a name='sect6' href='#toc6'>Author</a></h2> J. Cupitt - 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'>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>