Qt 使用Poppler實現pdf閱讀器的示例代碼
更新時間：2018年01月17日 10:31:45 作者：司馬懿字仲達
下面小編就為大家分享一篇Qt 使用Poppler實現pdf閱讀器的示例代碼，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧
開發(fā)環(huán)境 Qt5.5.1、Qt Creator 3.5.1
Qt實現pdf閱讀器和MFC實現pdf閱讀器，其實原理都是差不多的。
需要用到Poppler開源庫，下載地址如下 https://poppler.freedesktop.org/
如果只是要在window的gcc下運行的話，可以下載已經編譯好的庫 https://sourceforge.net/projects/poppler-win32/
注意：這個是MinGW版本的Qt，也就是運行在GCC環(huán)境下的庫，里面只包含 *.dll 和 *.a 。如果是Vistual Studio版本的Qt ，那么很不幸里面沒有 *.lib文件。
1、新建項目，在項目的根目錄新建一個“poppler”文件夾，將poppler中qt5目錄下的文件都丟進去（*.h頭文件，另外再將編譯好的2個*.a文件和2個*.dll丟進去，我這里多丟了實現的*.cc文件，因為*.cc已經被編譯成動態(tài)庫了，所以可以不用包含在代碼中）
2、在項目的pro配置文件中添加以下內容，引用poppler的頭文件和庫文件（注意：我這里是win32，所以前面加了win32前綴）
INCLUDEPATH += $$PWD/poppler win32: LIBS += -L$$PWD/poppler -llibpoppler win32: LIBS += -L$$PWD/poppler -llibpoppler-qt5
3、創(chuàng)建pdf工具類（該類負責與poppler庫做對接，主要負責獲取pdf的總頁數，和每頁的圖像）
（1）pdfutils.h
#ifndef PDFUTILS_H
#define PDFUTILS_H
#include <QObject>
#include <QImage>
#include <QSize>
#include <QDebug>
#include "poppler-qt5.h"
class PdfUtils
{
public:
explicit PdfUtils(QString filePath);
~PdfUtils();
//獲取指定頁pdf圖像(頁碼從0開始)
QImage getPdfImage(int pageNumber);
//獲取pdf總頁碼
int getNumPages();
//獲取pdf頁面大小
QSize getPageSize();
private:
QString filePath;
int numPages;
QSize pageSize;
void getPdfInfo();
};
#endif // PDFUTILS_H
（2）pdfutils.cpp
#include "pdfutils.h"
PdfUtils::PdfUtils(QString filePath) {
this->filePath = filePath;
getPdfInfo();
}
PdfUtils::~PdfUtils() {
}
QImage PdfUtils::getPdfImage(int pageNumber) {
QImage image;
Poppler::Document* document = Poppler::Document::load(filePath);
if (!document || document->isLocked()) {
// ... error message ....
delete document;
return image;
}
// Document starts at page 0
Poppler::Page* pdfPage = document->page(pageNumber);
if (pdfPage == 0) {
// ... error message ...
return image;
}
// Generate a QImage of the rendered page
image = pdfPage->renderToImage(72, 72, -1, -1, -1, -1);
if (image.isNull()) {
// ... error message ...
return image;
}
// after the usage, the page must be deleted
delete pdfPage;
delete document;
return image;
}
int PdfUtils::getNumPages() {
return numPages;
}
QSize PdfUtils::getPageSize() {
return pageSize;
}
void PdfUtils::getPdfInfo() {
numPages = 0;
Poppler::Document* document = Poppler::Document::load(filePath);
if (!document || document->isLocked()) {
// ... error message ....
delete document;
return;
}
numPages = document->numPages();
Poppler::Page* pdfPage = document->page(0);
pageSize = pdfPage->pageSize();
qDebug()<<pageSize;
delete pdfPage;
delete document;
}
4、pdf顯示類（pdf的右側顯示滾動條，①拖動滾動條翻頁 ②鼠標拖動pdf到最上或最底時翻頁）
注意：本文省略了頁面緩存，如果是真實的項目的話，本著嚴謹的態(tài)度，請務必緩存頁面
（1）mypdfcanvas.h（繼承父類的resizeEvent是為了 ①當pdf只有1頁時不顯示滾動條 ②當用戶拖動縮放窗口時動態(tài)改變pdf顯示尺寸）
#ifndef MYPDFCANVAS_H
#define MYPDFCANVAS_H
#include <QWidget>
#include <QVector>
#include <QMouseEvent>
#include <QPaintEvent>
#include <QPainter>
#include <QPaintEvent>
#include <QMap>
#include <QPalette>
#include <QResizeEvent>
#include "pdfutils.h"
class MyPdfCanvas : public QWidget
{
Q_OBJECT
public:
explicit MyPdfCanvas(QWidget *parent = 0);
~MyPdfCanvas();
void resizeEvent(QResizeEvent* e);
void paintEvent(QPaintEvent *e);
void mousePressEvent(QMouseEvent *e);
void mouseReleaseEvent(QMouseEvent *e);
void mouseMoveEvent(QMouseEvent *e);
void setMaxCachedNum(int maxCachedNum);
//如果不能解析pdf返回false
bool setPath(QString pdfPath);
//頁碼從0開始
bool setPage(int pageNumber);
//獲取頁數
int getNumPages();
float getScaledRatio();
//顯示裁剪后的圖片
bool showClipImage(int pageNumber, int x, int y, int w, int h);
//取消顯示裁剪圖片,恢復正常顯示
void cancelClip();
//實際獲取的pdf寬高度
QSize pdfActualSize;
signals:
void pageChanged(int currentPage);
private:
PdfUtils* pdfUtils;
QString pdfPath;
//最大緩存圖片數量
int maxCachedNum;
//用來緩存pdf的每一個頁面的圖像(從0開始)
QMap<int, QImage> cachedImageMap;
//用來存儲已緩存的pdf頁面序號(從0開始)
// QQueue<int> cachedPageQueue;
//當前頁碼(從0開始)
int currentPage;
//總頁碼(從0開始)
int numPages;
bool isMouseDown;
int lastMouseY;
//當前pdf頁面的圖像
QImage image;
int imageX;
int imageY;
int imageMinY;
//是否是剪裁狀態(tài)
bool isClip;
//獲取指定頁的圖片
bool getPdfImage(int pageNumber);
void reachTop();
void reachBottom();
//判斷是否需要發(fā)送重定位簽名框的信號
void needLocateSignArea();
};
#endif // MYPDFCANVAS_H
（2）pdfcanvas.cpp
#include "mypdfcanvas.h"
MyPdfCanvas::MyPdfCanvas(QWidget *parent) : QWidget(parent) {
pdfUtils = NULL;
imageX = 0;
imageY = 0;
isClip = false;
setAutoFillBackground(true);
}
MyPdfCanvas::~MyPdfCanvas() {
if(pdfUtils != NULL) delete pdfUtils;
}
void MyPdfCanvas::resizeEvent(QResizeEvent *e) {
image = this->cachedImageMap[currentPage];
if(!image.isNull()) {
float radio = (float)e->size().width()/(float)e->oldSize().width();
int imageHeight = image.height()* e->size().width()/image.width();
image = image.scaled(e->size().width(), imageHeight);
if(imageHeight < this->height()) {
imageY = (this->height()-imageHeight)/2;
//如果圖片高度小于控件高度，則圖片居中
// imageMinY = imageY;
imageMinY = 0;
imageY = imageMinY;
} else {
if(radio>0) {
imageY = (int)(imageY*radio);
if(imageY > 0) {
imageY = 0;
}
} else {
imageY = 0;
}
}
}
}
void MyPdfCanvas::paintEvent(QPaintEvent *e) {
QPainter* painter = new QPainter(this);
if(image.isNull()) {
painter->fillRect(this->rect(), Qt::transparent);
return;
}
painter->drawImage(0, imageY, image);
delete painter;
}
void MyPdfCanvas::mousePressEvent(QMouseEvent *e) {
isMouseDown = true;
lastMouseY = e->y();
}
void MyPdfCanvas::mouseReleaseEvent(QMouseEvent *e){
isMouseDown = false;
}
void MyPdfCanvas::mouseMoveEvent(QMouseEvent *e){
if(!isMouseDown || image.isNull()) {
return;
}
int distance = e->y() - lastMouseY;
lastMouseY = e->y();
imageY += distance;
if(imageY > 0) {
imageY = 0;
reachTop();
return;
} else if(imageY < imageMinY) {
imageY = imageMinY;
reachBottom();
return;
}
update();
}
void MyPdfCanvas::setMaxCachedNum(int maxCachedNum) {
this->maxCachedNum = maxCachedNum;
}
bool MyPdfCanvas::setPath(QString pdfPath) {
this->pdfPath = pdfPath;
if(pdfUtils != NULL) delete pdfUtils;
pdfUtils = new PdfUtils(pdfPath);
numPages = pdfUtils->getNumPages();
if(numPages > 0) {
isClip = false;
pdfActualSize = pdfUtils->getPageSize();
}
cachedImageMap.clear();
currentPage = 0;
imageY = 0;
lastMouseY = 0;
return numPages > 0;
}
bool MyPdfCanvas::setPage(int pageNumber) {
if(!getPdfImage(pageNumber)) {
return false;
}
isClip = false;
isMouseDown = false;
image = image.scaledToWidth(this->width());
imageMinY = this->height() - image.height();
if(image.height() < this->height()) {
//如果圖片高度小于控件高度，則圖片居中
// imageMinY /= 2;
imageMinY = 0;
imageY = imageMinY;
} else {
imageY = 0;
}
update();
return true;
}
int MyPdfCanvas::getNumPages() {
return numPages;
}
float MyPdfCanvas::getScaledRatio() {
int pdfWidth = pdfUtils->getPageSize().width();
return (float)this->width()/(float)pdfWidth;
}
bool MyPdfCanvas::showClipImage(int pageNumber, int x, int y, int w, int h) {
if(!getPdfImage(pageNumber)) {
return false;
}
isClip = true;
imageY = 0;
image = image.copy(x, y, w, h).scaled(this->size());
update();
}
void MyPdfCanvas::cancelClip() {
isClip = false;
setPage(currentPage);
}
bool MyPdfCanvas::getPdfImage(int pageNumber) {
if(pageNumber<0 || pageNumber >= numPages) {
return false;
}
if(cachedImageMap.contains(pageNumber)) {
image = cachedImageMap.value(pageNumber);
} else {
image = pdfUtils->getPdfImage(pageNumber);
if(!image.isNull()) {
cachedImageMap[pageNumber] = image;
pdfActualSize = image.size();
}
}
if(image.isNull()) {
return false;
}
currentPage = pageNumber;
return true;
}
void MyPdfCanvas::reachTop() {
if(currentPage > 0) {
emit pageChanged(currentPage-1);
}
}
void MyPdfCanvas::reachBottom() {
if(currentPage < numPages-1) {
emit pageChanged(currentPage+1);
}
}
5、pdf及右側滑塊的裝載容器
（1）mainwindow.h
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include <QScrollBar>
#include "mypdfcanvas.h"
#define SCROLLBAR_WIDTH 30
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
void resizeEvent(QResizeEvent* e);
bool setPdfPath(QString path);
//重新調整pdf界面大小
void resizeCanvas();
void setWidgetVisible(bool pdfCanvasVisible, bool scrollbarVisible);
public slots:
//當拖動pdf上滑到頂（或下滑到底）時觸發(fā)該方法
onPageChange(int currentPage);
//當滑動條的滑塊被滑動時，會調用該方法
onScrollBarValueChange();
private:
MyPdfCanvas *pdfCanvas;
QScrollBar *scrollbar;
};
#endif // MAINWINDOW_H
（2）mainwindow.cpp
#include "mainwindow.h"
MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
pdfCanvas = new MyPdfCanvas(this);
scrollbar = new QScrollBar(Qt::Vertical, this);
setWidgetVisible(false, false);
connect(pdfCanvas, SIGNAL(pageChanged(int)), this, SLOT(onPageChange(int)));
connect(scrollbar, SIGNAL(valueChanged(int)), this, SLOT(onScrollBarValueChange()));
}
MainWindow::~MainWindow() {
}
void MainWindow::resizeEvent(QResizeEvent *e) {
resizeCanvas();
}
bool MainWindow::setPdfPath(QString path) {
bool result = pdfCanvas->setPath(path);
if(result) {
int numPages = pdfCanvas->getNumPages();
if(numPages>1) {
scrollbar->setMaximum(numPages-1);
scrollbar->setValue(0);
}
pdfCanvas->setPage(0);
}
resizeCanvas();
return result;
}
void MainWindow::resizeCanvas() {
qDebug()<<"resize "<<this->rect()<<", "<<pdfCanvas->rect();
int numPages = pdfCanvas->getNumPages();
if(numPages == 1) {
pdfCanvas->setGeometry(this->rect());
setWidgetVisible(true, false);
} else if(numPages > 1) {
pdfCanvas->setGeometry(0, 0, this->width()-SCROLLBAR_WIDTH, this->height());
scrollbar->setGeometry(this->width()-SCROLLBAR_WIDTH, 0, this->width()-SCROLLBAR_WIDTH, this->height());
setWidgetVisible(true, true);
} else {
//numPages <= 0
setWidgetVisible(false, false);
}
}
void MainWindow::setWidgetVisible(bool pdfCanvasVisible, bool scrollbarVisible) {
pdfCanvas->setVisible(pdfCanvasVisible);
scrollbar->setVisible(scrollbarVisible);
}
MainWindow::onPageChange(int currentPage) {
pdfCanvas->setPage(currentPage);
}
MainWindow::onScrollBarValueChange() {
pdfCanvas->setPage(scrollbar->value());
}
6、調用方式
（1）main.cpp
#include "mainwindow.h"
#include <QApplication>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
MainWindow w;
w.resize(500, 500);
w.show();
QString path = "D://test.pdf";
w.setPdfPath(path);
w.setWindowTitle(path);
return a.exec();
}
7、實際效果圖
更新于2016-08-03
8、項目下載地址（使用當前最新的庫poppler-0.45.0、poppler-0.39.0-win32）
http://download.csdn.net/detail/chy555chy/9593364
該項目在win7（Qt5.1）、win10（Qt5.7）下測試過了，均可正常運行。
下圖為項目目錄中的poppler文件夾（已經刪去所有.cc文件），因為只用庫和頭文件，Qt便可隱式調用dll中的函數了。
更新于2016-08-22
你們評論中遇到的加載庫的時候就奔潰現象我還真沒遇到過。
下面是測試情況：
（1）當PDF文件未找到的情況，會輸出錯誤日志，但是并不會崩潰。
（2）當路徑中包含”中文“，且包含"空格"的情況，poppler是可以正常打開的。
以上這篇Qt 使用Poppler實現pdf閱讀器的示例代碼就是小編分享給大家的全部內容了，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
本文主要介紹了OpenCV中Grabcut算法的具體使用，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-08-08
這篇文章主要介紹了C++頭文件algorithm中的函數功能詳解,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-04-04
這篇文章主要介紹了C++之Boost::array用法簡介,較為詳細的分析了Boost::array中的常見用法,并用實例的形式予以總結歸納,需要的朋友可以參考下2014-10-10
這篇文章主要為大家詳細介紹了C++ socket實現miniFTP的相關資料,具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-11-11
這篇文章主要為大家詳細介紹了如何使用qt制作了一個簡單的圖片播放器，可以播放gif、png等格式圖片。文中的示例代碼講解詳細，需要的可以參考一下2022-12-12
這篇文章主要介紹了C++實現ping程序實例,涉及C++對于ICMP數據包的發(fā)送與回顯處理,具有一定的實用價值,需要的朋友可以參考下2014-10-10
利用C語言模擬實現qsort,strcpy,strcat,strcmp函數
這篇文章主要為大家詳細介紹了如何通過C語言模擬實現qsort(采用冒泡的方式),strcpy,strcat,strcmp等函數，文中的示例代碼講解詳細，感興趣的可以了解一下2022-11-11
這篇文章主要為大家詳細介紹了C語言學生信息管理系統(tǒng)小項目，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-01-01
這篇文章主要為大家詳細介紹了OpenGL繪制Bezier曲線的方法，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2020-04-04
這篇文章主要為大家介紹了C語言字符串函數，具有一定的參考價值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來幫助2022-01-01