基于MuPDF和Qt的PDF阅读器的开发
一、引言
设备上要渲染显示PDF文档,类似Adobe Reader、福昕阅读器等软件。如何去实现?Handling PDF这篇文档讨论介绍了在Qt应用程序中各种操作PDF的资料。从资料中看出,我们是要阅读渲染PDF文档到我们的设备中,关键还要能交叉编译移植到我们的设备上。在渲染显示方面整体给出三种方案:
- QtPDF(基于PDFium),不太好交叉编译。
- poppler-qt,与我们设备操作系统版本匹配的版本bug太多。
- muPDF,非常成熟,很多产品上都已使用,格式支持丰富,方便交叉编译。
最终选muPDF库来实现。
二、muPDF下载和编译
muPDF官网,muPDF-1.12.0源码下载。
1、交叉编译iMX6-ARM版本
修改Makerules
...
157:
158: ifeq "$(OS)" "imx6-linux"
159: CCPATH = /opt/linaro-14.04/gcc-linaro-arm-linux-gnueabihf-4.8/bin
160: CC = $(CCPATH)/arm-linux-gnueabihf-gcc
161: LD = $(CCPATH)/arm-linux-gnueabihf-gcc
162: AR = $(CCPATH)/arm-linux-gnueabihf-ar
163: CROSSCOMPILE=yes
164: HAVE_GLUT := no
165: HAVE_PTHREAD := yes
166: SYS_PTHREAD_CFLAGS :=
167: SYS_PTHREAD_LIBS := -lpthread
168: HAVE_X11 := yes
169: SYS_X11_CFLAGS += -I/opt/linaro-14.04/usr/include
170: SYS_X11_LIBS += -L/opt/linaro-14.04/usr/lib/arm-linux-gnueabihf -lX11 -lXext -lxcb -lXau -lXdmcp -lpthread
171: endif
172:
...
执行命令:make generate && make OS=imx6-linux HAVE_GLUT=no -j32
最后源码目录的build/release/下生成四个库文件和多个二进制程序工具。libcurl.a libmupdf.a libmupdfthird.a libmuthreads.a mjsgen mujstest mupdf-x11 mupdf-x11-curl muraster mutool
使用的时候把四个库放到Qt工程里面使用,curl又依赖libcrypto.a库,所以去交叉编译工具链下找到libcrypto.a放进去。
2、编译win版本
用VS打开源码目录下的platform/win32/mupdf.sln,把所有工程中的属性--配置属性--C/C++--代码生成--运行库改为多线程调试DLL(/MDd)
编译mupdf生成三个库libmupdf.lib、libthirdparty.lib
,编译libresources工程,生成libresources.lib
,目前项目需要这三个库就够了。
三、使用muPDF库
其实重点在于如何使用muPDF库,这个库的API实在是难用,也没有帮助文档,只能看它提供的例子或这小工具的源码来学习。
先看工程目录结构:
main.cpp
mainwindow.h
mainwindow.cpp
mupdfdocument.h
mupdfdocument_p.h
mupdfdocument.cpp
mupdfpage.h
mupdfpage_p.h
mupdfpage.cpp
pagerender.h
pagerender.cpp
sequentialpagewidget.h
sequentialpagewidget.cpp
mupdfdocument:主要实现加载文档,提供文档信息功能。对mupdf接口封装主要实现在mupdfdocument_p里面;
mupdfpage和mupdfpage_p:主要实现渲染单个页面,输出QImage。主要难度在reanderImage函数;
pagerender:主要是借助QThread线程来渲染单个PDF页面;
sequentialpagewidget:实现对PDF文件显示的封装,如何做到高效显示,而又不占用太多资源?如何实现跳页?放大?缩小?滚动页面?非常小的屏幕下实现页码的正确显示?这里面都有所体现。
整个工程,都是短时间完成的,并且没有时间对muPDF做深入研究,所以肯定还有很多不足之处,还请见谅。整个工程代码没什么大的难度,难点在如何封装使用muPDF的API,以及如何使用Qt的控件更有效率的显示出来。
这是基于VS2013的PDFReader的工程。
资源工程下载