im_initdesc(3)

im_initdesc3

Initialises an image descriptor to specific values

Usage

#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 )

Overview

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 ...

Also

im_open(3), im_setupout(3).

Releases

4 releases since Debian 3.1 (Sarge); the text changed 1 time.

  1. 3.1–4.0
  2. 5.0–6.0

Author

N. Dessipris - 22/04/1991

From libvips-dev 7.20.7-1+b3 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.