MuPDF是一款體積小巧、性能出眾的便攜型PDF閱讀器軟件。用它閱讀PDF文件，相比其他同類軟件清晰度更優，文字邊緣順滑無鋸齒，圖像顯示銳利清晰，能精準還原文檔原始排版與細節。該軟件擁有強大的CJK（中日韓）語言支持，可完美兼容亞洲各國語言的文檔編碼，無論是復雜的中文排版、日文假名還是韓文諺文，都能準確顯示，無亂碼、錯行問題。同時軟件啟動迅速、運行流暢，無需復雜安裝即可使用，既適配桌面端也支持移動設備，在保證功能完備的前提下，兼顧了便攜性與使用效率，是日常閱讀、處理各類文檔的優質選擇。

【軟件特色】

　　1. 文檔格式支持

　　PDF處理：支持PDF文檔的查看、渲染、編輯和轉換，包括高質量的文本和圖像渲染。

　　其他格式：除了PDF，還支持XPS、OpenXPS、CBZ、EPUB和FictionBook 2等多種文檔格式。

　　圖像格式：支持大約10種流行的圖像格式，如PNG、JPG、BMP、TIFF等，這些圖像格式可以像文檔一樣被處理。

　　2. 文檔處理功能

　　注釋與表單：支持在PDF文檔上進行注釋和填寫表單，這些功能在移動查看器上已可用，并計劃擴展到桌面查看器。

　　文本和圖像提取：可以從文檔中提取文本和圖像，支持多種格式的文本提取，如PDF、(X)HTML、XML、JSON、text等。

　　文檔轉換：支持將文檔轉換為其他格式，如HTML、SVG、PDF和CBZ等。

　　頁面操作：頁面可以通過多種方式插入、刪除、重新排列或修改，包括注釋和表單字段的添加。

　　加密與解密：完全支持密碼保護，包括解密、加密、加密方法選擇、權限級別和用戶/所有者密碼設置。

　　3. 渲染與顯示

　　高質量渲染：渲染器專為高質量抗鋸齒圖形量身定制，能夠以精確到像素幾分之一的度量和間距呈現文本，在屏幕上再現打印頁面外觀時獲得最高保真度。

　　多平臺支持：支持Windows、macOS、Linux、Android和iOS等多種操作系統，提供了C API，便于其他編程語言的綁定。

　　Web支持：通過WASM庫，支持在瀏覽器和Node環境中使用與mutool run和Java相同的API。

　　4. 交互式功能

　　注釋與電子簽名：支持注釋、電子簽名等交互式功能，特別適用于需要在PDF文檔進行批注和簽署的業務工作流程。

　　文本涂黑刪除：提供了涂黑刪除文本的功能，在處理需要保密的文檔時顯得尤為重要。

　　文本搜索：支持文本搜索功能，方便用戶快速定位文檔中的信息。

【軟件優勢】

　　1、專為高質量的抗鋸齒圖像量身打造。

　　2、以像素級的精度高品質呈現文字和文字間的間距。

　　3、獲得最高級別的顯示保真度，在設備屏幕上再現印刷紙張的顯示效果。

　　4、小巧、快速，但功能完備。

　　5、它可以支持PDF文件的透明化、加密、文件中的超鏈接、批注、搜索等眾多功能。用戶還可以利用它查看XPS/OPENXPS文件。

【快捷鍵說明】

　　1、〔ESC〕：快速關閉正在瀏覽的PDF文件，或按〔q〕鍵。

　　2、〔n〕：按〔n〕、〔→〕鍵或空格鍵可翻下一頁。

　　3、〔b〕：按〔b〕或〔←〕鍵可翻上一頁。

　　4、〔+〕：放大頁面。

　　5、〔-〕：縮小頁面。

　　6、〔r〕：文件向右旋轉90度。

　　7、〔l〕：向左旋轉90度。

　　8、〔Shift〕+〔n〕：往下翻10頁。

　　9、〔Shift〕+〔b〕：往前翻10頁。

　　10、〔m〕：標記某一頁（方便之后跳回查看）。

　　11、〔t〕：跳回之前按〔m〕標記的頁面。

　　12、〔1+g〕、〔2+g〕、〔3+g〕……：按數字鍵后再按〔g〕鍵，直接跳轉到對應頁碼的頁面。

【注意事項】

　　1、編譯環境配置

　　依賴庫安裝：確保系統已安裝所有必要的依賴庫，如 zlib、libjpeg、libpng 等。在 Ubuntu 系統上可通過以下命令安裝：

　　bash

　　sudo apt update

　　sudo apt install build-essential zlib1g-dev libjpeg-dev libpng-dev

　　子模塊初始化：克隆項目后需初始化子模塊（如使用 git submodule update --init --recursive），國內用戶若遇到下載失敗，可手動修改 .gitmodules 文件中的 URL 為國內鏡像地址。

　　編譯工具鏈：確保已安裝 make、gcc 或 clang 等編譯工具。Windows 用戶需使用 Visual Studio 2022 并安裝 "C++桌面開發" 工作負載。

　　2、跨平臺兼容性

　　操作系統支持：MuPDF 支持 Linux、Windows、macOS、Android 和 iOS。不同平臺需適配特定依賴庫（如 macOS 需 XQuartz，Android 需 NDK 版本 9 或更高）。

　　文件路徑處理：在代碼中處理文件路徑時，需考慮跨平臺路徑分隔符差異（如 Windows 用 \，Linux/macOS 用 /）。

【常見問題】

　　1、文檔加載失敗

　　問題表現：白屏、崩潰或提示 "Cannot open PDF"。

　　解決方案：

　　檢查文件路徑是否正確，確保文件可訪問。

　　驗證文檔完整性（嘗試用其他 PDF 查看器打開）。

　　更新 MuPDF 至最新版本，修復已知解析問題。

　　2、內存泄漏

　　問題表現：長時間運行后內存占用持續增長。

　　解決方案：

　　使用內存檢測工具（如 Valgrind）定位問題代碼。

　　確保在使用 MuPDF API 時正確管理內存資源，避免不必要的分配和釋放。