@node Using libgimpprint, Integrating libgimpprint, Overview, Top
@chapter Using libgimpprint
@cindex using
This chapter describes how to write programs that use libgimpprint.
@section Code prerequisites
To use libgimpprint with a program, several steps must be taken:
@enumerate
@item Include the master libgimpprint header @code{<gimp-print/gimp-print.h>.}
@item Call @code{stp_init()}.
@item Link with libgimpprint.
@end enumerate
The following is a short example program. It does not do anything useful,
but it does everything required to link with libgimpprint and call other
functions from libgimpprint.
@example
#include <gimp-print/gimp-print.h>
int
main (int argc, char *argv[])
@{
stp_init ();
return (0);
@}
@end example
@section Linking with libgimpprint
To link a program with libgimpprint, then @samp{-lgimpprint} needs to be passed
to the compiler when linking. For example, to compile and link @file{prog.c}
the following commands would be used:
@example
gcc -c prog.c
gcc -o prog -lgimpprint prog.o
@end example
The compiler and linker flags needed may vary depending on the options
GIMP-Print was configured with when it was built. The
@command{gimpprint-config} script will give the correct parameters for
the local installation (@pxref{gimpprint-config}).