Native Linux C ABI rich form interchange
既有 forms.import 操作通过调用方带版本的 InputIO 回调接受 FDF RV 和 XFDF value-richtext,并经 OutputIO 发布真实更新的 PDF
V1 ABI 版本、导出符号和回调表布局保持不变;该绑定面向原生 Linux x64
{"schemaVersion":1,"type":"forms.import","format":"xfdf","fontFamily":"DejaVu Sans","fontSize":12}
目标 PDF 必须已加载;InputIO 提供实际表单数据字节,而不是另一个 PDF
inline-xhtml-v1 档案通过 bounded native XHTML decoder 保留混合 Unicode 文本顺序、段落与显式换行、继承的行内字体大小、RGB 颜色、字重、斜体、下划线、删除线和段落对齐
可选的命名字族按继承的 CSS 字族列表选择已配置程序;任意 CSS 布局、外部样式表、表格、图像和垂直对齐仍是独立能力
fontFamily 选择原生字体提供者的真实 regular、bold、italic 和 bold-italic 程序;只加载实际富值所需的样式,外加标量字段使用的 regular 程序
部署的 Fontconfig 配置必须能提供目标字族与字体;请求的字体不可用时应用正常提供者回退,fontStyles 描述的是已加载样式槽,并不证明已安装字体
字体程序随准备好的 PDF 内嵌字体流和真实外观返回给调用方;JSON 响应不暴露字体文件路径
fontSize 为零时,无样式 XHTML 使用解码器默认 12 磅;显式的受支持 XHTML 字体大小保留各自数值
| 结果字段 | 含义 |
|---|---|
updated | 变更的末端字段数,包括受支持的仅样式变更 |
richFieldCount | 解码输入中的富字段数,包括等价的未变化值 |
fontStyles | 实际加载的字体槽,按 regular、bold、italic、boldItalic 排序 |
richXMLProfile | 解码输入含富字段时为 inline-xhtml-v1 或 inline-xhtml-font-families-v1 |
fontFamilies | 提供可选命名字族数组时的已配置字族标签 |
文本和受支持样式一致的等价规范化与非规范化富标记是幂等的;未变化的只读字段保留其源 RV,不同受支持样式则强制只读保护
零变更导入发布精确已提交的私有 PDF 快照,包括既有签名或加密修订,不累积空交叉引用修订;调用方输入字节或后端文件的变化不会替换该已加载快照
导入经 native rich import transaction 保留已认证 AES 安全、真实签名修订、DocMDP P1/P2/P3 决策和 FieldMDP 锁
合并字体程序以 limits.memoryBytes 的四分之一为界,另有每字体原生限制;既有的表单数据、glyph、对象、输出和结果限制继续生效
回调在调用线程上同步执行;接受部分输入与输出回调,解析、字体加载、外观准备和发布期间取消保持有效
句柄只在 PDF 与 JSON 回调都成功后提交;回调错误或取消保留先前状态,已由 sink 接收的部分字节由调用方丢弃
能力声明 formData.richXML=true、兼容默认 richXMLProfile=inline-xhtml-v1、两个 richXMLProfiles、至多十六个标签的可选命名字族选择以及四种受支持 fontStyles;注释交换仍为 false
Form-data callbacks and limits · Native Linux C ABI · Signature trust options