QtPdfium 技术文档

QtPdfium 技术文档

qtpdfium Pdf Redening on Qt 项目地址: https://gitcode.com/gh_mirrors/qt/qtpdfium

1. 安装指南

1.1 系统要求

• 支持的平台：Linux、Mac、Windows、Android、iOS
• 需要安装Qt开发环境

1.2 安装步骤

1. 克隆项目：

   git clone --recursive https://github.com/paulovap/qtpdfium
   

2. 进入项目目录：

   cd qtpdfium
   

3. 使用qmake生成Makefile：

   qmake
   

4. 编译项目：

   make
   

5. 安装项目（可能需要sudo权限）：

   make install
   

6. 跨平台编译： 根据需要，在不同的平台上重复上述步骤。

2. 项目使用说明

2.1 加载PDF文件

使用QPdfium类加载PDF文件：

#include <QtPdfium/QPdfium>

QPdfium pdf("mypdf.pdf");
qDebug() << pdf.isValid(); // 应返回true

2.2 获取页面数量

使用QPdfium::pageCount()方法获取PDF文件的页面数量：

int pageCount = pdf.pageCount();
qDebug() << "Page count:" << pageCount;

2.3 访问页面

通过索引访问特定页面：

QPdfiumPage page = pdf.page(0);
qDebug() << "Page width:" << page.width();

2.4 生成页面图像

将页面渲染为QImage对象：

QImage image = page.image(3); // 渲染为3倍大小

2.5 提取文本

提取页面中的文本内容：

QString pageText = page.text();
qDebug() << "Page text:" << pageText;

2.6 iOS平台特殊处理

在iOS平台上，由于是静态链接库，需要手动初始化：

#ifdef Q_OS_IOS
    // 由于在IOS上是静态库，需要手动初始化
    PdfiumGlobal global;
#endif

3. 项目API使用文档

3.1 QPdfium类

• QPdfium(const QString &filePath)：构造函数，加载PDF文件。
• bool isValid()：检查PDF文件是否有效。
• int pageCount()：获取PDF文件的页面数量。
• QPdfiumPage page(int index)：通过索引获取特定页面。

3.2 QPdfiumPage类

• int width()：获取页面宽度。
• int height()：获取页面高度。
• QImage image(int scaleFactor)：将页面渲染为QImage对象，scaleFactor为缩放因子。
• QString text()：提取页面中的文本内容。

4. 项目安装方式

4.1 源码安装

按照安装指南中的步骤进行安装。

4.2 跨平台编译

根据目标平台（如Desktop、Android、iOS等），重复上述安装步骤。

---

通过以上文档，您应该能够顺利安装和使用QtPdfium项目。如有任何问题，欢迎贡献代码或提出改进建议。

qtpdfium Pdf Redening on Qt 项目地址: https://gitcode.com/gh_mirrors/qt/qtpdfium