| .TH IM_SETUPOUT 3 "11 April 1990" |
| .SH NAME |
| im_setupout \- set up an image descriptor for WIO output |
| .SH SYNOPSIS |
| .B #include <vips/vips.h> |
| |
| .B int im_setupout(image) |
| .br |
| .B IMAGE *image; |
| .SH DESCRIPTION |
| .B im_setupout(3) |
| makes a descriptor ready for WIO writing. If the descriptor is a memory |
| buffer, enough memory is allocated to be able to hold all of the pels of the |
| image. If the descriptor is an output file, then the header is written to |
| disc. |
| |
| Typically, for WIO, you should have |
| |
| int |
| im_wombat( in, out ) |
| IMAGE *in, *out; |
| { |
| if( im_iocheck( in, out ) ) |
| return( -1 ); |
| |
| ... check parameters, check image descriptors |
| ... for type-compatibility, etc. etc. |
| |
| if( im_cp_desc( out, in ) ) |
| return( -1 ); |
| |
| ... set fields in out for the type of image you |
| ... wish to write |
| |
| if( im_setupout( out ) ) |
| return( -1 ); |
| |
| ... process from input to output, reading from in->data |
| ... and writing to out with im_writeline(3) |
| |
| return( 0 ); |
| } |
| .SH RETURN VALUE |
| The function returns 0 on success and -1 on error. |
| .SH SEE\ ALSO |
| im_cp_desc(3), im_iocheck(3). |
| .SH COPYRIGHT |
| .br |
| N. Dessipris |
| .SH AUTHOR |
| N. Dessipris \- 11/04/1990, updated on 22/04/1991 |