im_system(3) im_system(3)
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 computa-
tion, 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 direc-
tory. 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 im_system(3)
im_system 7.14.5 - Generated Tue Sep 9 08:25:09 CDT 2008