核心引擎參考

概覽

nextpdf/core 引擎文件採逐一說明模組的方式組織。下列各頁面分別涵蓋核心 Portable Document Format 2.0（PDF 2.0）引擎的一個命名空間。請使用這份地圖，找出你正在使用的符號是由哪個模組定義，再閱讀該模組頁面，以取得確切的型別與方法。

另有四個模組提供更深入的子系列頁面：Contracts、Core、HTML 與 Security。命名空間地圖列出所有模組；子系列頁面緊接在後。

命名空間地圖

頁面	主題
Accelerator：Spectrum sidecar 用戶端	Spectrum 加速 sidecar 用戶端。
無障礙：標記基本元件與 PDF/UA-2 結構模型	標記基本元件與結構模型。
Ast：語意文件樹與序列化	語意文件樹與其序列化。
稽核：具確定性的合規證據匯出	合規證據的匯出。
條碼：一維與二維符號編碼器	一維（1D）與二維（2D）符號編碼器。
Chaos：確定性韌性情境測試框架	韌性情境測試框架。
Cli：命令處理器與外部驗證器轉接器	命令處理器與外部驗證器轉接器。
Compliance（合規）：PDF/R-1 驗證器、Arlington 文法與生命週期工具	驗證器、文法與生命週期工具。
Config：不可變文件設定	不可變的文件設定。
一致性（conformance）：ConformanceMode 的路由與驗證邊界	ConformanceMode 的路由與驗證邊界。
Content：文字與結構化內容的模型	文字與結構化內容的模型。
ContentStream：PDF content-stream 輸出器	content-stream 輸出器。
契約：41 個公開介面（SPI）	公開服務提供者介面（SPI）。
Core：Document 門面與職責 trait	Document 門面與職責 trait。
文件：DParts、split / merge 與廠商擴充	Document Part、分割、合併與廠商擴充。
Event（事件）：PSR-14 生命週期事件分類	生命週期事件分類。
Exception：型別化例外階層	型別化的例外階層。
字型：值型別、嵌入與後備	字型值型別、嵌入與後備機制。
Form：AcroForm 互動式欄位與扁平化	互動式表單欄位與扁平化。
圖形：path（路徑）、shading（漸層著色）與 transform（座標轉換）的基本元件	path（路徑）、shading（漸層著色）與 transform（座標轉換）的基本元件。
HTML：HTML+CSS 轉 PDF 繪製子系統	HTML 與 Cascading Style Sheets（CSS）算繪子系統。
Inspect：PDF 內省與預檢	內省與預檢。
版面配置：頁首、頁尾、欄、書冊與頁面管理員	頁首、頁尾、欄、書冊與頁面管理員。
線性化：Fast Web View 輸出	Fast Web View 輸出。
Render manifest（渲染請求清單）：可攜式渲染請求	可攜式算繪請求。
中繼資料：建構 XMP 封包與串流式讀取	Extensible Metadata Platform（XMP）封包建構與串流式讀取。
多媒體：呈現、媒體片段與螢幕參數	呈現、媒體片段與螢幕參數。
導覽：註解、連結、大綱、動作與附件	註解、連結、大綱、動作與附件。
可觀測性：雜湊鏈式 SIEM 日誌與算繪報告	安全日誌與算繪報告。
PageBackfill：保留頁面緩衝區	保留頁面緩衝區。
效能：記憶體碎片分析器	記憶體碎片分析器。
安全性：加密、加密政策與簽章介面	加密、加密政策與簽章介面。
Support：共用工具 + Clock + Sleeper	共用工具、Clock 與 Sleeper。
Telemetry：OpenTelemetry 橋接與無操作備援	OpenTelemetry 橋接與無操作備援。
文字：塑形接縫、CJK 與文字段處理	塑形接縫與文字段處理，包含中文、日文與韓文（CJK）文字。
字型排印：字型登錄表、子集化、CMap、編碼、BiDi	字型登錄表、子集化、CMap、編碼，以及雙向文字。
ValueObjects：領域基本型別與單位	領域基本型別與單位。
Writer：PDF 2.0 序列化器與 xref	PDF 2.0 序列化器與交叉參照層。

子系列頁面

有四個模組會依領域提供更深入的子系列頁面，進一步說明細節。每一個子系列頁面都隸屬於上方對應的模組頁面。

Contracts

頁面	主題
契約 / 條碼	Barcode 契約。
契約 / 文件	文件、工廠與登錄表的契約。
契約 / 擷取	檢視與擷取契約。
契約 / 可觀測性	可觀測性與工作進度契約。
契約 / 安全性原則	安全性原則契約。
契約 / 簽章	簽章契約。
契約 / 串流	串流 writer 與 cursor 的契約。
契約 / 排版	排版契約。

Core

頁面	主題
Core / Document 門面	Document 門面參考。
Core / HasLayout trait	HasLayout trait 參考頁面。
Core / HasOutput trait	門面的輸出職責。
Core / HasPages trait	門面的頁面管理職責。
Core / HasSecurity trait	門面的安全性職責。
Core / HasTextOutput trait	門面的文字輸出職責。

HTML

頁面	主題
HTML 算繪管線	算繪管線。
HTML 引擎分層契約	算繪引擎的分層契約。
HTML 單趟串流限制	單趟串流模型及其限制。
CSS 解析器：cascade 與 specificity	cascade 與 specificity 模型。
分頁媒體 CSS 預覽旗標（GCPM 流動內容、具名頁面、頁面浮動）	分頁媒體 CSS 預覽旗標。
CSS Grid 的保留模式配置（grid-template-areas）	CSS Grid 的保留模式配置。

Security

頁面	主題
加密：AES-256（CBC）與 AES-256-GCM	文件加密參考頁面。
安全性 / 簽章：CMS、RFC 3161 時間戳記、LTV 與信任	核心簽章、時間戳記與信任介面。

另請參閱

• 參考資料 — 整個「參考」區段的導覽地圖，涵蓋矩陣、錯誤、一致性與政策。
• 錯誤參考 — 引擎會拋出的每一個例外，且依領域分類。
• 擴充功能開發 — 公開 SPI 的擴充功能開發總覽。