如何在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;
}
相关推荐
兢兢业业的小白鼠7 分钟前
Java高级JVM知识点记录,内存结构,垃圾回收,类文件结构,类加载器
java·开发语言·jvm·tomcat
Niuguangshuo17 分钟前
Python设计模式:代理模式
开发语言·python·代理模式
能来帮帮蒟蒻吗24 分钟前
GO语言学习(16)Gin后端框架
开发语言·笔记·学习·golang·gin
落榜程序员26 分钟前
Java 基础-29-final关键字-详解
java·开发语言
JavaPub-rodert1 小时前
一道go面试题
开发语言·后端·golang
6<71 小时前
【go】静态类型与动态类型
开发语言·后端·golang
车载小杜2 小时前
基于指针的线程池
开发语言·c++
沐知全栈开发2 小时前
Servlet 点击计数器
开发语言
m0Java门徒2 小时前
Java 递归全解析:从原理到优化的实战指南
java·开发语言
桃子酱紫君3 小时前
华为配置篇-BGP实验
开发语言·华为·php