MuPDF 1.23.0 Documentation

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

摘要

The document provides comprehensive guidance on using and integrating MuPDF, including building the library, using it with C++, accessing command-line tools, and understanding the C API. It also covers language bindings for C++, Python, and C#, as well as the use of third-party libraries required by MuPDF. The guide includes details on installation, configuration, and API changes between versions.

AI总结

### MuPDF 1.23.0 文档总结

#### 1. 快速入门指南
- **获取源代码**：可通过官网下载、GitHub仓库或直接从Git仓库克隆。
- **构建库**：支持Windows、macOS等平台，提供详细的构建步骤。
- **安装验证**：验证安装后需检查是否正确配置。
- **支持格式**：支持多种文档格式，包括PDF、XPS、SVG等。

#### 2. 使用 MuPDF (C 语言)
- **基本用法**：提供简单的示例代码，展示如何加载和显示文档。
- **函数参数**：常见函数参数包括上下文、文档句柄等。
- **错误处理**：支持自定义错误回调函数。
- **多线程支持**：提供上下文克隆功能，支持多线程操作。
- **命名规范**：低层次函数和类命名规则明确，便于调用。

#### 3. MuPDF WASM 支持
- **安装**：需安装相关依赖。
- **文档操作**：支持加载和创建 PDF 文档。
- **开发环境**：提供详细的开发配置指南。

#### 4. 命令行工具
- **mupdf-gl**：用于 OpenGL 渲染。
- **muraster**：用于文档 rasterization。
- **mutool**：功能强大的文档处理工具，支持加密、布局调整等。

#### 5. C API
- **核心模块**：包含上下文管理、异常处理、字符串操作等功能。
- **上下文管理**：所有函数的第一个参数是 `fz_context`，用于管理资源和错误。
- **模块化设计**：MuPDF 分为多个模块，每个模块提供特定功能。

#### 6. JavaScript 支持
- **类索引**：提供完整的类和方法索引。
- **颜色与矩阵**：支持颜色空间和矩阵操作。
- **对象协议**：定义了对象之间的交互协议。
- **缓冲与文档处理**：提供缓冲区操作和文档管理功能。

#### 7. 语言绑定
- **C++ API**：自动从 C API 生成，支持类和命名空间。
- **Python/C# API**：提供低层次和类感知的 API，支持回调和自动引用计数。
- **命名规范**：统一了低层次函数和类的命名规则。

#### 8. 第三方库
- **依赖库**：包括 freetype、harfbuzz、libjpeg 等，均为常见开源库。
- **版本信息**：列出各库的版本及功能。

#### 9. 更新日志
- **2022-08-29**：简化 C++/Python/C# 类和函数命名规则。
- **2022-05-11**：新增实验性 C# API 文档。
- **2022-03-26**：发布新版本 Python 包，支持预构建 Wheels。
- **改进**：修复了引用计数问题、回调支持改进等。

#### 10. 参考文档
- **CAPI**：详细文档供开发者参考，涵盖所有公共接口。
- **API 变更**：记录了不同版本间的 API 变更，便于升级和维护。

总结：MuPDF 1.23.0 提供了全面的文档支持，涵盖从快速入门到高级开发的各个方面。其模块化设计、跨平台支持和丰富的 API 使其成为 PDF 处理的强大工具。