MuPDF 1.25.0 Documentation

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

摘要

文档提供了MuPDF的使用指南和API文档，涵盖快速入门、C语言接口、JavaScript集成、命令行工具以及CAPI模块。内容包括安装、基本使用、错误处理、多线程支持、文档操作、坐标系统、命令行工具（如mupdf-gl、muraster、mutool）以及JavaScript API的详细说明。文档还介绍了MuPDF的模块结构、核心API功能、 Fitz上下文的创建和使用、加密选项、SVG输出设置等。

AI总结

《MuPDF 1.25.0 Documentation》提供了MuPDF的使用指南和API文档，以下是主要内容的总结：

### 1. **快速入门指南**
- **获取源码**：可以从官方渠道获取MuPDF的源代码。
- **构建库**：按照文档说明编译和构建MuPDF库。
- **安装验证**：通过简单的测试程序验证安装是否成功。
- **支持格式**：支持PDF、XPS、CBZ、EPUB、SVG等多种文件格式。

### 2. **C语言接口**
- **基本用法**：提供了一个简单的示例程序，展示了如何使用MuPDF的基本功能。
- **错误处理**：通过回调函数或异常处理来管理错误。
- **多线程支持**：支持多线程环境，但需注意上下文的管理。
- **上下文克隆**：允许在多线程中克隆上下文以避免竞争条件。
- **编码规范**：推荐使用特定的编码风格以确保代码的一致性和可维护性。

### 3. **WASM接口**
- **安装**：提供详细的安装步骤以在Web环境中使用MuPDF。
- **加载文档**：支持通过JavaScript加载和显示文档。
- **创建PDF**：可以通过API创建新的PDF文档。
- **调试工具**：提供了一个调试工具，用于查看和分析文档。

### 4. **坐标系统**
- **原点和方向**：MuPDF的坐标系统以左下角为原点，Y轴向上增长。
- **单位**：使用点（point）作为单位，与PDF标准一致。

### 5. **命令行工具**
- **mupdf-gl**：一个基于OpenGL的文档查看器，支持多种格式（PDF、XPS、CBZ、EPUB、SVG）。
- **muraster**：用于将PDF页面转换为 raster 图像。
- **mutool**：一个多用途工具，支持文档操作、调试和分析。

### 6. **C API**
- **模块化设计**：MuPDF分为多个模块，核心模块包含运行时上下文、异常处理和基础功能。
- **上下文管理**：所有API的第一个参数通常是`fz_context`，用于管理内存、缓存和错误处理。
- **内存管理**：支持自定义内存分配器，并提供缓存大小的配置选项。

### 7. **JavaScript集成**
- **使用方式**：可以通过`mutool run`或`mupdf.js`包在Node.js和浏览器环境中使用。
- **API支持**：提供了一系列JavaScript API，包括文档操作、页面管理、链接处理等。
- **兼容性**：支持ECMAScript 5，不支持ECMAScript 6及以上版本。

### 8. **其他功能**
- **SVG输出选项**：支持将文本渲染为``元素或``元素。
- **文件处理选项**：支持加密、解密、设置权限、设置密码等功能。
- **调试工具**：通过`mutool trace`可以跟踪页面渲染过程中设备的调用情况。

### 9. **附录**
- **安装和集成**：提供了将MuPDF添加到项目的方法。
- **文档查看器**：展示了如何在移动设备上集成文档查看器活动。
- **自定义选项**：允许通过CSS和参数自定义EPUB布局的样式和行为。

总结来看，MuPDF 1.25.0 提供了强大的文档处理能力，支持多种格式和接口，适合开发者在不同环境中进行集成和扩展。