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
7 Mar 2000