Raspberry Pi framebuffer PDF阅读器 - fbpdf

本文同步自(最佳显示效果请点击):https://zohead.com/archives/raspberry-pi-fbpdf/

最近拷了几个 PDF 电子书到 Raspberry Pi 树莓派小主板系统上,准备小充下电,结果在 Debian Wheezy Raspbian 的 Linux X11 系统下用以前用的 xpdf 软件看 PDF 的不爽:由于 Raspberry Pi 的 CPU 是 ARMv6 700MHz 的,性能一般,而且内存只有 256MB,所以跑 Linux X11 虽然没什么问题,但老感觉看大一点的 PDF 有点拖顿。

后来装了比较小巧的 mupdf 软件(Raspbian 系统的话直接用 apt-get install mupdf 命令就可以安装)之后在 X11 环境下看 PDF 电子书似乎情况好了很多,mupdf 功能很简单,甚至都没有独立的启动方式,直接双击 PDF 文件运行,或者通过命令行方式运行,主界面也没有工具栏之类的多余东西,操作全部键盘来完成,浏览 PDF 的速度也很快,对中文支持也很好。关于 mupdf 的介绍请参考其官网:http://www.mupdf.com/

后来想到平时用 Raspberry Pi 主要还是用命令行模式,我对 Linux X11 一向比较反感 ^_^,感觉是不是可以直接用 framebuffer 的形式看 PDF,结果还真找到一个 fbpdf 软件。

fbpdf 是基于 mupdf 的代码基础上实现的纯 framebuffer 下的 PDF 阅读器,和 mupdf 的功能基本相当,用这个可以省去 X11 和 GTK+ 等一堆臃肿的玩意,在 framebuffer 上看不仅速度快而且占用内存也小,并且可以充分利用 Raspberry Pi 上 framebuffer 的硬件加速。但不幸的是 Raspberry Pi 的 Raspbian 源中没有 fbpdf 包,看来只能自己编译了。

fbpdf 的 Git 版本库地址(可以直接用 git clone 命令弄下来哦):

http://repo.or.cz/w/fbpdf.git

首先到 mupdf 官网下载 mupdf 源代码和 mupdf-thirdparty 第三方程序的源代码:

http://www.mupdf.com/download/mupdf-1.1-source.tar.gz
http://www.mupdf.com/download/mupdf-thirdparty.zip

需要说明的是我的编译环境是 armhf 的 Raspbian 默认开发环境。编译 mupdf 之前需要先安装 libfreetype6-dev、libjbig2dec0-dev、libjpeg8-dev 等开发软件包。mupdf 编译安装好之后会产生 fitz 库的头文件和静态库文件 libfitz.a,libfitz.a 在编译 fbpdf 时需要用到。

特别需要注意的是 mupdf 和 fbpdf 使用的是修改过的 openjpeg-1.5.0 版本的 openjpeg 库,不能直接使用 Raspbian 系统中的 libopenjpeg2 库,因此需要先编译 mupdf-thirdparty 中的 openjpeg-1.5.0 库,为了防止和 Raspbian 默认的 openjpeg 库冲突,建议将 openjpeg-1.5.0 库安装到自定义的目录(非 /usr/lib、/usr/local/lib 等系统默认使用的目录),然后编译 fbpdf 时直接使用 openjpeg-1.5.0 产生的静态库文件 libopenjpeg.a。

在 Raspberry Pi 编译 fbpdf 时会有一些小报错,需要修改下代码和 Makefile,编译 fbpdf 时由于要使用 libfitz.a 静态库,因此生成的 fbpdf 可执行文件也会比较大(我编译产生的将近 6MB)。

在 Raspbian 系统的默认 framebuffer 文本终端下运行 fbpdf /home/xxx.pdf (/home/xxx.pdf 为 PDF 文件的路径)就可以查看 PDF 文件了,你的 Raspberry Pi 在用 fbpdf 打开 PDF 时很可能会遇到这个错误直接退出:fbpdf: fbval_t doesn’t match fb depth。

简单说明下这个错误的原因:

fbpdf 程序中默认使用的 framebuffer 颜色数(BPP)是 32 位的,但 Raspberry Pi 默认的 framebuffer 只使用 16 位颜色(也就是下面的 framebuffer_depth 默认为 16),这样 fbpdf 程序运行时检查 framebuffer 参数发现不匹配就会报上面的错误,我尝试过跳过这项检查可以不报错,但 PDF 文件的显示渲染效果相当差。

解决方法也是必须要有的:

注意:不建议使用此方法,建议直接使用最下面的 16 位 framebuffer 版本。

打开启动分区下的 config.txt 配置文件(路径为:/boot/config.txt),加入下面两行然后重启系统就可以解决:

framebuffer_depth=32
framebuffer_ignore_alpha=1

第一行 framebuffer_depth=32 指定 Raspberry Pi 的 framebuffer 使用 32 位颜色,第二行 framebuffer_ignore_alpha=1 是在使用 32 位颜色时才需要指定的,表示忽略 ARGB 颜色中的 alpha 通道。需要说明的是即使 config.txt 配置文件中指定了使用 32 位实际上也只有 20120615 种颜色的哦,不过对使用上没有影响的。

有关 Raspberry Pi 的 config.txt 配置文件的详细说明请参考这里:http://elinux.org/RPi_config.txt

把上面的配置文件修改好重启之后,下面是用我编译好的 fbpdf 程序查看一个 5MB 的 PDF 电子书的截图,在 Raspberry Pi 这样的微型板上速度是相当之快的:

从截图中可以看到图片和中文都是可以正常显示的哦。

framebuffer 模式下的 fbpdf 也是全部通过键盘操作,不过快捷键和 mupdf 是不同的,将常用的快捷键简单介绍如下(注意是 J、K 等单按键是区分大小写的哦),大多数快捷键都可以在前面加数字指定次数之类的(深得 VI 的精髓啊,哈哈)。具体请参考 fbpdf 代码中的 README 说明文档:

快捷键 操作
Ctrl + F 或 J 下一页(5J 跳至下面第 5 页,6J 类推)
Ctrl + B 或 K 上一页
G 跳到具体某页,G 前面没有数字则跳到最后一页
z 按 10% 的倍数放大(15z 为放大到 150%)
i 显示 PDF 文件信息
q 退出 fbpdf
j 向下滚动(不自动翻页)
k 向上滚动(不自动翻页)
h 向左滚动(不自动翻页)
l 向右滚动(不自动翻页)
Ctrl + L 重新绘制
e 重新加载当前 PDF 文件
f 适合高度
w 适合宽度

不想自己费劲去修改编译的朋友欢迎下载我已经编译好的 fbpdf 单文件程序:

http://miseal.googlecode.com/files/fbpdf-raspberry-pi-v20121009.7z

2012.10.17 更新:

将近发现 Raspberry Pi 的 32 位 framebuffer 存在颜色显示不完全的问题,建议使用下面的使用 16 位 framebuffer 的 fbpdf 程序,运行也非常好(上面的不建议使用,config.txt 中也不需要改成 32 位了):

http://miseal.googlecode.com/files/fbpdf-raspberry-pi-v20121016.7z

运行此 fbpdf 程序需要先安装 libfreetype6、libjbig2dec0、libjpeg8 等软件包(apt-get install 直接安装就行的)。

此 fbpdf 程序是我自己修改编译的,我编译时网上尚无其它人在 Raspberry Pi framebuffer 下使用过 fbpdf 软件,使用中有任何问题欢迎提出指正哦,玩的开心 ^_^

  1. jimmy:

    Great works! Thanks a lot~





*