Using the Library
Working with XpdfRasterizerThe XpdfRasterizer library uses an opaque handle (type
PDFHandle) to represent a PDF file. Multiple PDF files can be open simultaneously (each with its own handle).
Any program that uses the library must include the XpdfRasterizer header file:
Using XpdfRasterizer in a multithreaded applicationIn a multithreaded application, the
pdfInitLibraryfunction must be called before any other functions are called. Unlike in single-thread applications where this is optional, the
pdfInitLibrarycall is required in multithreaded applications. Each PDF handle must be used by only one thread. Given that constraint, all XpdfRasterizer functions (other than
pdfInitLibrary) are thread-safe.
Compiling & linking on WindowsThe XpdfRasterizer library is supplied as a DLL (
XpdfRasterizer.dll) and an import library (
The following instructions are for Microsoft Visual C++ 6. Similar steps should work for other development environments.
- Add the include file directory: in the "Project Settings" dialog,
under the "C/C++" tab, in the "Preprocessor" category, add the library
include file directory (
- Add the import library: in the "Project Settings" dialog, under
the "Link" tab, in the "General" category, add the library
- Either add the library directory
....\XpdfRasterizer\lib) to your executable search path, or copy
XpdfRasterizer.dllinto the same directory as your application's executable.
Compiling & linking on LinuxThe XpdfRasterizer library is supplied as a shared library (
When compiling C or C++ code that uses the XpdfRasterizer library,
you'll need to supply a "
-I" flag pointing to the
directory containing the XpdfRasterizer includes. When linking, you'll
need to supply a "
-L" flag pointing to the directory
containing the XpdfRasterizer library, and a
-lXpdfRasterizer" flag to link with the library.
Before running the application, make sure that the XpdfRasterizer
library directory is on the library search path. This this can be
done either by setting the
variable or by editing the system-wide
Compiling & linking on Mac OS XUsing XpdfRasterizer on OS X is very similar to using it on Linux. The shared library has a different extension (
libXpdfRasterizer.dylib), and you'll need to set the
Static libraryXpdfRasterizer includes a static library as well as the dynamic library. To use it, include
XpdfRasterizerStatic.hin place of
XpdfRasterizer.h, and link to
libXpdfRasterizer.a(Linux, Mac OS X).
Example codeThe XpdfRasterizer library distribution includes a sample program,
pdftoimg.c, located in the
examplesdirectory. This program demonstrates the use of the various XpdfRasterizer functions. It converts a PDF file to a series of image files, one per page - monochrome/grayscale/color and image file format can be chosen by uncommenting lines in the source file.
To build on Linux, edit the included Makefile and set the
variables according to the instructions inside the Makefile. Then run
To build on Windows, create a Visual C++ project, as described above.