核心引擎参考

概览

nextpdf/core 引擎文档按模块组织。下列每个页面都对应核心 PDF 2.0（便携式文档格式 2.0）引擎中的一个命名空间。你可以通过这张映射表找到正在处理的符号所属模块，再进入对应模块页面，查看准确的类型与方法说明。

其中，契约、Core、HTML 与安全性这四个模块还提供更深入的子族页面。命名空间映射列出所有模块；子族页面列出这些深入页面。

命名空间映射

页面	主题
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 内容流写出器	内容流写出器。
契约：41 个公开接口（SPI）	公开服务提供方接口（SPI）。
Core：Document 门面与职责 trait	Document 门面及职责 trait。
文档：DParts、split / merge 与厂商扩展	文档部件（Document Part）、拆分、合并与厂商扩展。
Event（事件）：PSR-14 生命周期事件分类	生命周期事件分类。
Exception：类型化异常层级	类型化异常层级。
字体：值类型、嵌入与后备机制	字体值类型、嵌入与后备机制。
Form：AcroForm 交互式表单字段与扁平化	交互式表单字段与扁平化。
图形：path（路径）、shading（渐变着色）与 transform（坐标转换）基础组件	路径、渐变着色与坐标变换的基础组件。
HTML：HTML+CSS 转 PDF 渲染子系统	HTML 与层叠样式表（CSS）的渲染子系统。
Inspect：PDF 自省与预检	自省与预检。
布局：页眉、页脚、栏、小册子、页面管理器	页眉、页脚、分栏、小册子与页面管理器。
线性化：Fast Web View 输出	Fast Web View 输出。
Render manifest（渲染请求清单）：可移植的渲染请求	可移植的渲染请求。
元数据：XMP 包构建与流式读取	可扩展元数据平台（XMP）包的构建与流式读取。
多媒体：呈现、媒体片段与屏幕参数	呈现、媒体片段与屏幕参数。
导航：注解、链接、大纲、动作与附件	注解、链接、大纲、动作与附件。
可观测性：哈希链式 SIEM 日志与渲染报告	SIEM 日志与渲染报告。
PageBackfill：保留页面缓冲	保留页面缓冲。
性能：内存碎片分析器	内存碎片分析器。
安全性：加密、加密策略与签名接口	加密、加密策略与签名接口。
Support：共享工具 + Clock + Sleeper	共享工具、Clock 与 Sleeper。
Telemetry：OpenTelemetry 桥接与无操作回退	OpenTelemetry 桥接与无操作回退。
文字：塑形接缝、CJK 与文字段处理	塑形接缝与文字段处理，包括中文、日文与韩文（CJK）文本。
字体排印：字体注册表、子集化、CMap、编码、BiDi	字体注册表、子集化、CMap、编码与双向文本。
ValueObjects：领域原语 + 单位	领域原语与单位。
Writer：PDF 2.0 序列化器 + xref	PDF 2.0 序列化器和交叉引用层。

子族页面

有四个模块按领域拆分出子族页面，提供更深入的说明。每个子族页面都归属于上方对应的模块页面。

契约

页面	主题
契约 / 条码	条码契约。
契约 / 文档	文档、工厂与注册表契约。
契约 / 提取	检查与提取契约。
契约 / 可观测性	可观测性与作业进度契约。
契约 / 安全策略	安全策略契约。
契约 / 签章	签章契约。
契约 / 流式	流式写入器与游标契约。
契约 / 排版	排版契约。

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 解析器：层叠与优先级	层叠与优先级模型。
分页媒体 CSS 预览标志（GCPM 运行内容、命名页面、页面浮动）	分页媒体 CSS 的预览标志。
面向 CSS Grid 的保留模式布局（grid-template-areas）	面向 CSS Grid 的保留模式布局。

安全性

页面	主题
加密：AES-256（CBC）与 AES-256-GCM	文档加密说明。
安全 / 签章：CMS、RFC 3161 时间戳、LTV 与信任	核心签名、时间戳与信任接口。

另请参阅

• 参考文档 — 整个参考选项卡的导览，涵盖矩阵、错误、一致性与策略。
• 错误参考 — 引擎按领域抛出的所有异常。
• 扩展开发 — 面向公开 SPI 的扩展开发中心。