<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_IOCHECK(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_incheck, im_outcheck, im_iocheck - checks image descriptors for WIO <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips.h></b> <p> int im_incheck( in ) <br> IMAGE *in; <p> int im_outcheck( out ) <br> IMAGE *out; <p> <b>int im_iocheck( in, out)</b> <br> <b>IMAGE *in, *out;</b> <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_incheck.3.html'>im_incheck(3)</a> checks that an image descriptor is suitable for WIO input (ie. all of its pels can be found from im->data). If possible, it transforms the descriptor to make WIO input ok using the following rules: <p> IM_PARTIAL: the descriptor is magically turned into an IM_SETBUF descriptor. Memory is allocated and the image generated into that. The old partial callbacks are closed down, and the descriptor reformed as a IM_SETBUF. <p> IM_OPENOUT: if the descriptor has been written to, it is automatically ‘rewound,‘ that is, it is closed and reopened as an IM_MMAPIN descriptor. <p> IM_SETBUF: just checks that the descriptor has been written to. <p> See the manual page for <a href='im_setupout.3.html'>im_setupout(3)</a> for a skeleton program. <p> <a href='im_outcheck.3.html'>im_outcheck(3)</a> checks that a descriptor is suitable for WIO output with <a href='im_writeline.3.html'>im_writeline(3)</a> . If it sees an IM_PARTIAL image, it turns it magically into an IM_SETBUF image. <p> <a href='im_iocheck.3.html'>im_iocheck(3)</a> simply calls <a href='in_incheck.3.html'>in_incheck(3)</a> for image in and <a href='im_outcheck.3.html'>im_outcheck(3)</a> for image out. <h2><a name='sect3' href='#toc3'>Return Value</a></h2> All functions returns 0 on success and -1 on error. <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_open.3.html'>im_open(3)</a> , <a href='im_cp_desc.3.html'>im_cp_desc(3)</a> , <a href='im_setupout.3.html'>im_setupout(3)</a> , <a href='im_makerw.3.html'>im_makerw(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> National Gallery <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'>SeeAlso</a></li> <li><a name='toc5' href='#sect5'>Copyright</a></li> <li><a name='toc6' href='#sect6'>Author</a></li> </ul> </body> </html>