如何在C++中使用mupdf操作pdf文件（一）

部署

mupdf是一个pdf库，不仅可以显示pdf文件，还可以创建、分割、合并、更改pdf文件。而且，除了pdf以外，它还支持mobi、epub、fb2等其它文件。

所以，如果我们有操作pdf等电子书的开发需求，使用mupdf是一个不错的选择。

需要强调的是，mupdf的核心API是C语言的。

但是，它使用自动化地方式，支持C++、Python、C#等语言绑定。我们在不同的语言中使用的时候，直接使用官方的语言绑定就可以了。

Linux

在Linux系统中，有现成的mupdf的C++绑定开发库。虽然不同的发行版中名字不同，但是差异不大。

比如，在Fedora系统中，C语言的核心库叫做mupdf-devel，C++的绑定库叫做mupdf-cpp-devel。

执行

sudo dnf install mupdf-cpp-devel

之后，就自动安装好了。

安装之后，mupdf的头文件在/usr/include/mupdf目录中，动态链接库文件在/usr/lib64中，叫做libmupdfcpp.so（跟Windows中略有差异）。

Windows

在Windows系统中，需要自己编译一下，编译出C++需要的头文件和库，步骤略多一点。

首先，从github上检出mupdf的源代码。

git clone --recursive git://git.ghostscript.com/mupdf.git

注意，这里必须加上–recursive，因为有些第三方库的源文件需要同时检出。

如果忘了加上这个参数，就需要在检出的目录里，执行子模块的检出命令。

cd mupdf
git submodule update

检出源代码以后，就可以使用Visual Studio进行编译了。方法是打开platform/win32目录里面的mupdf.sln方案文件。

mupdf方案里面，有一个mupdfcpp项目，就是C++语言绑定。

但是，要编译mupdfcpp，需要额外的步骤，因为C++语言绑定的源代码是生成的。在编译mupdfcpp之前，需要先生成它的源文件。

方法是使用scripts/mupdfwrap.py脚本，而且这个脚本需要libclang库。

所以，可以在VS命令提示符里面完成这个过程：

pip install libclang setuptools
cd mupdf
python scripts/mupdfwrap.py -b m01

执行完成以后，会在Python的目录里生成一个mupdfcpp64.dll。把这个dll复制到自己的方案里面，或者放在全局的dll目录里面，就可以使用了。

使用

根据mupdf的语言绑定文档所言，mupdf的C++除了包装了C语言的API以外，还有一些额外的便利。

如，在C语言中使用mupdf的时候，大量的变量都是以fz_开头的，而C++使用了命名空间mupdf。即fz_document，对应mupdf::FzDocument，我们可以直接在源代码中使用

using namespace mupdf;

之后，直接使用驼峰命名的类名。

如，在C语言中使用mupdf的时候，需要先初始化一个fz_context，大量的函数都以这个fz_context为参数。而在C++中，这个上下文不是必须的，mupdf的C++绑定自动初始化了这个变量。

再比如，mupdf的C语言API，使用setjmp()实现了异常机制，我们在代码中需要使用

fz_try {

}
fz_catch {

}

代码块的方式，捕获这种异常。而mupdf的C++绑定，把这种异常与C++的异常机制结合了。

示例

下面写一个小函数，实现加载一个PDF文件，并且把指定的页面渲染成一张图片。

using namespace std;
using namespace mupdf;

FzPixmap
loadPdfPage (const string &path, int page_number)
{
  auto doc = FzDocument (path.c_str ());
  auto page = doc.fz_load_page (page_number);
  // 取得页面大小
  auto rect = page.fz_bound_page ();
  auto width = rect.x1 - rect.x0;
  auto height = rect.y1 - rect.y0;
  cout << "pdf page " << page_number << " size: " << width << "," << height
       << endl;
  // 设置缩放比例
  auto matrix = FzMatrix::fz_scale (1.0f, 1.0f);
  // 设置旋转角度
  matrix = fz_pre_rotate (matrix, 0.0f);
  auto pixmap = page.fz_new_pixmap_from_page (matrix, fz_device_rgb (), 0);
  return pixmap;
}