im_initdesc(3) initialises an image descriptor to specific values


#include <vips/vips.h>

void im_initdesc( IMAGE *image,
     int xsize, int ysize,
     int bands, int bandbits, int bandfmt,
     int coding, int type,
     float xres, float yres,
     float xo, float yo )


im_initdesc(3) initialises the image descriptor according to the entered values. More specifically the Xsize, Ysize, Bands, BandFmt, Coding, Type, Xres, Yres, Xoffset and Yoffset members of the descriptor are initialised by the correspondingly entered arguments. The members fd, baseaddr, data and filename are not handled by this function. The order of the args is the same as in vips/vips.h.

The bandbits parameter is deprecated and ignored by this function: you can always pass zero.

Example: make a 512 by 512 one-band memory buffer.

   if( !(im = im_open( "temp", "t" )) )
        /* Error ...
   im_initdesc( im,
       512, 512,
       1, 0, FMTUCHAR,
       NOCODING, B_W,
       1.0, 1.0,
       0, 0 );
   if( im_setupout( im ) )
       /* Error ...


im_open(3), im_setupout(3).


N. Dessipris


N. Dessipris - 22/04/1991