表单、容器与集成面

HotPDF 为需要确定性 PDF 处理而不执行任意脚本的应用程序提供事务式表单编辑和有界集成 API

事务式表单与 FDF

THPDFFormEditSession 跟踪脏字段、重新生成外观，并支持撤销、重做、提交和回滚

THPDFFormEventKind 和 THPDFFormEventBinding 选择事件源，而 THPDFConstrainedFormActionKind 和 THPDFConstrainedFormAction 描述允许的变更

THPDFFormEventResult 报告分派结果，THPDFFormEditHistoryEntry 暴露可逆的编辑历史

焦点、指针、按键和提交事件只分派调用方绑定的设置、切换、清除、撤销或重做动作

FDF 交换通过流覆盖字段值、批注和状态数据，同时保留现有的轻量级纯字段 API

XFA 展平

条码和专用 UI 控件使用只读文本回退，而签名和选择列表保留原生 AcroForm 映射

流式子表单遵循内容区和页面区换行、保留组、溢出前导与尾随目标以及重复页面区分页

附件与组合文档

嵌入文件可在字节限制下直接提取到调用方流，同时验证 MD5、声明大小、日期、MIME 类型和关联文件关系

组合文档编辑支持详细信息、平铺、隐藏和自定义视图、有序排序键、嵌套文件夹、导航器元数据以及模式或条目元数据移除

THPDFPortfolioSortKeyArray 为组合文档导航承载稳定的多键排序

有界集成

每个 JSON 操作都可以限制内存、运行时间、对象数、解压比率和输出大小，并提供结构化的预算超限结果

版本化的扁平 C 回调 ABI 将随机访问源字节直接写入解析器缓冲区，通过可重试的部分写入流式输出，并暴露取消、进度、诊断、固定状态码和经过验证的不透明句柄

语料最小化只在稳定失败签名保持可复现时移除对象区间和字节范围，通过进程安全锁和原子替换在多次运行间持续保留最小用例，并发布稳定的 SHA-256 寻址元数据

确定性差分探针在重复引擎运行间比较解析、渲染、文本和保存域，保存指纹使用可复现的序列化而非时间派生的文档标识符

THPDFRegressionDomain 标识每个面，而版本化 JSON 报告以稳定顺序保留签名、不稳定性、隔离错误、引擎名称和输入 SHA-256

主要 API