如何在C++中使用Poppler库读取PDF文件（一）
如果只是读取、渲染pdf文件，除了mupdf以外，在Linux系统中还可以使用Poppler库。Poppler的历史非常古老，X窗口系统中的pdf查看工具xpdf，使用的就是poppler。
Poppler在Linux各发行版，以及BSD族系统之中，都有现成的二进制安装包。
而且，Poppler还提供了glib、Qt5、Qt6等多种上层库的支持。本文中的示例，就采用Qt6的接口。
开发环境
Poppler按照上层接口的不同，需要不同的头文件与库文件。
原生API
比如，如果使用原生的C++接口，就需要使用poppler-devel安装包，包含Poppler底层的头文件，头文件目录是/usr/include/poppler，连接/usr/lib64/libpoppler.so动态库。
为了简化这一操作，可以使用pkg-config文件。
如：
~/$ pkg-config --cflags --libs poppler
-I/usr/include/poppler -lpoppler
GLIB API
如果在glib程序中使用Poppler，就可以使用Poppler的glib绑定。
还是使用pkg-config：
~/$ pkg-config --cflags --libs poppler-glib
-I/usr/include/poppler/glib -I/usr/include/cairo -I/usr/include/freetype2 -I/usr/include/glib-2.0 -I/usr/li
b64/glib-2.0/include -I/usr/include/libxml2 -I/usr/include/libpng16 -DWITH_GZFILEOP -I/usr/include/harfbuzz
-I/usr/include/sysprof-6 -pthread -I/usr/include/pixman-1 -I/usr/include/poppler -lpoppler-glib -lgobject-
2.0 -lglib-2.0 -lcairo
我们可以看到，头文件目录是/usr/include/poppler/glib，而连接的库也大量使用了glib的底层动态库。
如果我们真的使用Poppler的glib绑定，就会发现把PDF的页面导出成图片的时候，是使用的GdkPixbuf。
Qt API
如果使用Qt的绑定，就根据Qt的版本，还有不同的二进制库。对于Qt5、Qt6的分别是poppler-qt5-devel与poppler-qt6-devel。
我们后文全都使用poppler-qt6-devel举例。
还是使用pkg-config看一下：
~/$ pkg-config --cflags --libs poppler-qt6
-I/usr/include/poppler/qt6 -I/usr/include/poppler -lpoppler-qt6
如果使用CMake构建，就可以使用CMake的PkgConfig来获取相应的变量，不再赘述。
打开PDF
使用poppler-qt6的时候，PDF相关的类位于Poppler名字空间，PDF文档的类是Document，即我们需要把PDF文档解析成Poppler::Document。
这个解析过程是load()静态方法。
需要注意的是，Poppler的Qt绑定，大量使用了智能指针来方便内存的管理。
比如上文提到的Poppler::Document::load()方法，返回的就是一个unique_ptrPoppler::Document。
所以，我们需要使用unique_ptrPoppler::Document来保存加载的PDF文件，在智能指针的作用域超出以后，Poppler::Document被自动释放。
另外，load函数的第一个参数，是一个QString。如果我们是C++的std::string，需要使用QString::fromLocal8Bit来转化成QString。
比如我们定义一个PDF类：
using namespace Poppler;
class PDF {
public:
// 加载
bool load(const std::string &filename);
// 总页数
int pageCount();
// 页面大小
QSizeF pageSizeF(int pagenum);
// 搜索
QList<QRectF> pageSearch (int pagenum, const string &str);
// 渲染
QImage pageRender (int pagenum, int ix, int iy, double zoom, int degree);
private:
// 智能指针
unique_ptr<Document> m_doc;
};
加载方法：
bool PDF::load(const std::string &filename)
{
m_doc = Document::load (QString::fromLocal8Bit (filename));
if (m_doc == nullptr)
{
// 如果加载失败，尝试使用密码解锁
auto text = QInputDialog::getText (nullptr, "password", "input password");
auto pass = QByteArray::fromStdString (text.toStdString ());
m_doc = Document::load (QString::fromStdString (filename), pass, pass);
}
if (m_doc)
return true;
else
return false;
上面的过程，返回的doc就是一个unique_ptrPoppler::Document。
取得页面信息
通过unique_ptrPoppler::Document的numPages()方法，可以取得总页数。
int
PDF::pageCount ()
{
return m_doc->numPages ();
}
另外通过page(int pagenum)方法，可以取得一个unique_ptrPoppler::Page，这个Page支持的方法比较多，可以做各种操作。
比如，可以通过Poppler::Page的pageSizeF()方法，取得页面的大小。
QSizeF
PDF::pageSize (int pagenum)
{
auto page = m_doc->page (pn);
auto size = page->pageSizeF ();
return size;
}
再比如，可以通过Poppler::Page的search()方法，搜索页面的文本：
QList<QRectF>
PDF::pageSearch (int pn, const string &str)
{
auto page = mDoc->page (pn);
auto results = page->search (QString::fromLocal8Bit(str));
return results;
}
返回的是一个模板类QList<QRectF>，每一个QRectF都是一个矩形。
渲染PDF
还可以通过Poppler::Page的renderToImage()方法，把一个页面渲染成一个图片。
但是renderToImage()方法，比前面介绍的稍微复杂一点儿。
它的原型是：
QImage renderToImage(double xres = 72.0, double yres = 72.0, int x = -1, int y = -1, int w = -1, int h
= -1, Rotation rotate = Rotate0) const;
- 其中，xres、yres分别是横竖两个方向的字符大小。默认都是72.0。如果我们要缩放页面，就需要根据缩放比例调整这个值。
- 而x、y是页面的左上角坐标，w是页面宽度，h是页面高度。如果我们要渲染页面的一部分，就可以灵活调整这4个数值。
- 而Rotation是控制渲染的方向，默认是原始方向，即Rotate0，还可以是Rotate90、Rotate180、Rotate270，可以通过字面意思猜出来，这是页面旋转的角度。
所以，以下代码可以根据输出页面大小、缩放以及方向来渲染一个PDF页面为一个QImage。
QImage
ApvlvPDF::pageRender (int pagenum, int ix, int iy, double zoom, int degree)
{
auto xres = 72.0, yres = 72.0;
xres *= zoom; yres *= zoom;
auto width = zoom * ix, height = zoom * iy;
auto prot = Poppler::Page::Rotate0;
if (degree == 90)
prot = Poppler::Page::Rotate90;
if (degree == 180)
prot = Poppler::Page::Rotate180;
if (degree == 270)
prot = Poppler::Page::Rotate270;
auto page = mDoc->page (pagenum);
auto image = page->renderToImage (xres, yres, 0, 0, width, height, prot);
return image;
}