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

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;
				mupdf用于将pdf转化为图片版本：/home/zjm/activemq/mupdf-1.11-source编译 make prefix=/usr/local install 
prefix后面跟的是目标目录，正常应为/usr/local/mupdf现象： 
1、无权限：用sudo 
2、glfw未找到，需要自己编译glfw 
    编译步骤：1、在mupdf-1.11-source目录下cd
				有时候需要从pdf中提取图片，那么此时可以使用mupdf库，如果采用vs2013版本，那么此时就需要考虑mupdf库的版本了，编译过多次之后，最终成功的版本是1.15.0，代码实例如下：
// TestPdf2png.cpp : 定义控制台应用程序的入口点。
#include "stdafx.h"
* pdfextract -- the ultimate way to extract images and fonts from pdfs
#include "mupdf/fitz.h