Poster of Linux kernelThe best gift for a Linux geek
IM_SYSTEM

IM_SYSTEM

Section: C Library Functions (3) Updated: 7 Mar 2000
Local index Up
 

NAME

im_system - run a command on an image  

SYNOPSIS

#include <vips/vips.h>

int im_system(im, cmd, out)
IMAGE *im;
const char *cmd;
char **out;

 

DESCRIPTION

im_system() runs a command on an image, returning the command's output as a string. This string should be freed with im_free() when you've finished with it.

The command is executed with the system(3) call; the first '%s' in the command being substituted for a filename.

For example:

im_system( im, "vips2dj %s | lpr", &result )

will run the command vips2dj(1) on the image, piping the result to the printer.

If the IMAGE is a file on disc, then the filename will be the name of the real file. If the image is in memory, or the result of a computation, then a new file is created in the temporary area called something like "vips_XXXXXX", and that filename given to the command. The file is deleted when the command finishes.

The environment variable TMPDIR can be used to set the temporary directory. If it is not set, it defaults to "/tmp".

 

RETURN VALUE

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

SEE ALSO

system(3), vips2dj(1)  

COPYRIGHT

2000 The National Gallery and Birkbeck College


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 21:48:27 GMT, April 16, 2011