MuPDF 1.22.0 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: mupdf.readthedocs.io

摘要

文档主要介绍了如何获取、构建和使用MuPDF库。内容包括快速入门指南、使用C语言接口的基本示例、命令行工具的使用、CAPI接口的详细说明、语言绑定（如C++、Python和C#）以及渐进式加载的实现方式。文档还提供了详细的更新日志，记录了各个版本的功能改进和修复。

AI总结

《MuPDF 1.22.0 Documentation》是一份关于MuPDF库的详细指南，涵盖了安装、使用、API以及变更日志等内容。以下是文档的核心内容总结：

### 1. 快速入门指南
- **获取源码**：可通过官方发布页面、GitHub仓库或直接克隆Git仓库获取。
- **构建库**：支持Windows、macOS等多种平台，Windows用户可通过Visual Studio解决方案文件进行构建，macOS用户可通过命令行脚本构建。
- **安装验证**：安装完成后可通过示例程序验证是否正确安装。
- **支持的文件格式**：支持PDF、XPS、SVG等多种文件格式。

### 2. 使用MuPDF（C语言接口）
- **基本使用示例**：提供了一个简单的C语言示例程序，展示了如何加载和显示PDF文件。
- **错误处理**：支持通过`fz_try`和`fz_catch`进行异常处理。
- **多线程支持**：通过上下文克隆实现多线程环境下的使用，避免共享异常栈的问题。
- **上下文克隆**：允许从一个主上下文克隆出多个上下文，每个上下文共享资源但独立异常栈。
- **编码规范**：强调命名规范和编码风格，确保代码的一致性和可维护性。

### 3. 命令行工具
- **`mupdf-gl`**：用于OpenGL渲染。
- **`muraster`**：用于 rasterization（光栅化）。
- **`mutool`**：功能强大的命令行工具，支持PDF操作、文本提取、图像处理等。
- **`mutool JavaScript API`**：提供基于JavaScript的扩展接口。

### 4. CAPI（C语言应用编程接口）
- **模块划分**：MuPDF分为多个模块，包括核心模块（上下文、异常处理）、渲染模块、文本处理模块等。
- **核心上下文**：所有函数的第一个参数通常是`fz_context`，用于管理缓存、异常等。

### 5. 语言绑定
- **C++接口**：提供C++封装的API，简化了C语言接口的使用。
- **Python和C#接口**：通过SWIG生成Python和C#绑定，支持在Python和C#中使用MuPDF功能。
- **安装Python模块**：可通过pip安装预编译的Python模块，支持Windows和Linux。
- **示例代码**：提供Python和C#的基本PDF查看器示例，帮助用户快速上手。
- **变更日志**：
- **2023-02-14**：简化构建流程，修复与最新libclang的兼容性问题。
- **2023-01-20**：新增Python对MuPDF Stories的支持，修复Windows构建问题。
- **2022-11-23**：改进Python绑定，支持更多功能，如文本跨度访问器。
- **2021-09-29**：发布Python绑定版本1.19.0，提供预编译的Windows和Linux安装包。

### 6. 进度式加载
- **什么是进度式加载**：允许在文件下载过程中逐步渲染内容。
- **线性化文件**：支持使用“linearized”文件进行进度式下载。
- **字节范围请求**：通过字节范围请求实现进度式加载。

### 7. 变更日志
- **1.20到1.21**：无重大API变更。
- **1.19到1.20**：扩展文本搜索API，支持区分独立搜索结果。

### 8. 兼容性
- 提供详细的API变更记录，确保向后兼容性，同时通过小幅度调整优化API设计。

### 总结
《MuPDF 1.22.0 Documentation》全面介绍了MuPDF的功能、使用方法和开发接口，适合开发者快速上手和深入使用。文档内容结构清晰，涵盖了从安装到高级功能的各个方面，特别强调了多线程支持、语言绑定和进度式加载等核心特性。