im_writeline(3)

im_writeline3

Writes a line of data in the image descriptor

Usage

#include <vips/vips.h>

int im_writeline(ypos, image, buffer)
int ypos;
IMAGE *image;
char *buffer;

Overview

im_writeline(3) writes the ypos line of an image held in buffer to either the output buffer image (previously set by im_setbuf(3)) or to an output file (previously set by im_openput(3)). The function provides uniform treatment of output irrespectively whether it is a file or a buffer image.

You should be careful that the buffer does indeed contain enough data for a complete line of pels --- see lsize(3).

Any evaluation callbacks which have been added to image are triggered --- see im_generate(3) and im_add_eval_callback(3).

Return value

The function returns 0 on success and -1 on error.

Releases

Unchanged in 4 releases since Debian 3.1 (Sarge).

  1. 3.1–6.0

Bugs

This function changed in VIPS6: programs written previously must be modified by removing the last argument of the old im_writeline(3).

Author

N. Dessipris 23/04/1991

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