The Poppler Qt4 interface library

0.10.1

The Poppler Qt4 interface library, libpoppler-qt4, is a library that allows Qt4 programmers to easily load and render PDF files. The Poppler Qt4 interface library uses poppler internally to do its job, but the Qt4 programmer will never have to worry about poppler internals.

Current Status

The Poppler Qt4 interface library is quite stable and working.

Example Programs

Examples programs can be found in the qt4/test directory. The Poppler Qt4 interface library is also used in the development version of KDE's document viewer Okular. The source files for Okular's PDF plugin (Poppler-based) can be found on the subversion server of the KDE project, under this URL.

How to use the Poppler Qt4 interface library in three easy steps

Programmer who would like to use the Poppler Qt4 interface library simply need to add the following line to their C++ source files:

#include <poppler-qt4.h>

A PDF document can then be loaded as follows:

QString filename;

Poppler::Document* document = Poppler::Document::load(filename);
if (!document || document->isLocked()) {

  // ... error message ....

  delete document;
  return;
}

Pages can be rendered to QImages with the following commands:

// Paranoid safety check
if (document == 0) {
  // ... error message ...
  return;
}

// Access page of the PDF file
Poppler::Page* pdfPage = document->page(pageNumber);  // Document starts at page 0
if (pdfPage == 0) {
  // ... error message ...
  return;
}

// Generate a QImage of the rendered page
QImage image = pdfPage->renderToImage(xres, yres, x, y, width, height);
if (image.isNull()) {
  // ... error message ...
  return;
}

// ... use image ...

// after the usage, the page must be deleted
delete pdfPage;

Finally, don't forget to destroy the document:

delete document;