原生注释回退

HPDFRenderHeadlessPagePNG 为没有 normal 外观的受支持注释构造临时外观

既有 normal 外观优先;激活状态下的畸形外观仍会显式失败

源文档保持不变:生成的流和字体属于渲染操作,用后即释放

几何与静态内容

回退覆盖 Link 边框,Square、Circle、Line、Polygon、PolyLine、Ink、Highlight、Underline、StrikeOut、Squiggly、FreeText、Text、Caret、Stamp、FileAttachment、Sound、Redact 预览轮廓

Line 几何包括十种线端样式和引导线;受支持边框包括实线、虚线和下划线样式,外加明暗条带的斜面与内嵌矩形边框,显式的空颜色数组保留透明语义

Popup、Projection 和 Screen 在没有 normal 外观时没有独立可绘制内容;激活的 3D 环境、音频、附件和链接 action 不在静态栅格渲染范围内

可见性与 optional content 检查在回退构造之前进行;临时外观保留页裁剪以及既有的查看/打印、NoZoom 和 NoRotate 几何规则

行标题与浮雕边框

行标题经由同一条临时 Unicode 文本 Form 路径消费 Cap、CP、CO、Contents、RC 和 DS,实测 Inline 间隙、Top 放置和相对端点的偏移

长标题使用线上方放置;显式段落换行被保留,空 plain 或富文本让普通线保持原样

标题边界同时保留临时 Form BBox 和注释矩形;普通页面内容裁剪不变

矩形斜面与内嵌边框使用方向相反的明暗条带,边框和内部不透明度相互独立;零宽度和空颜色数组保留其透明语义

未知的具名边框样式使用实线默认值,非名称样式仍是畸形输入

颜色策略、字体生命周期和独立验收覆盖见注释装饰

FreeText

plain 文本支持 PDFDocEncoding、UTF-16 和带 BOM 的 UTF-8;XHTML 富文本支持继承的默认样式和文本流 RC 条目

受支持的默认外观操作符为 Tf、g、rg、k、Tc 和 Tw;Tf 字号为零时请求自动适配

内嵌默认 TrueType 字体使用文档字体字节;受支持的标准字体和富文本 family 使用本地平台解析器

临时文本外观使用显式只读 family 构建器,包括仅 Preview/Print 的 TrueType 轮廓字体;完整字体字节和权限标志被保留,而既有的可编辑构建器保留其原有准入

DA 字体名先经 Catalog AcroForm.DR.Font 解析,再到页资源;默认绑定缺失时,页资源和可识别的标准别名是恢复路径

文本布局支持对齐、直角旋转、矩形 differences 和 callout 几何;生成的字体资源与既有资源及加密源流相互隔离

限制与未完成的 handler

操作数、token、解码字节、工作内存和输出限制适用于生成的几何、文本和字体;取消和渲染失败保留与既有外观相同的源与发布契约

没有外观的 Screen 没有默认静态图像或边框;提供了 normal 外观时在查看和打印用法下都保持优先

缺失外观在 PDF 1.2–1.7 中是可选的;PDF 2.0 要求外观,其指定例外除外,因此 missing-appearance Path 夹具验证的是恢复能力,而不是符合 PDF 2.0 的写行为

独立的裸 CFF2 流、非默认 variation 坐标、已文档化 DA profile 之外的操作符以及更多的回退 handler 不在这个实现之内;有限的验收控制项不能确立任意变换后的栅格包络

Tr4 到 Tr7 使用累积的字形轮廓裁剪;其四个有限的双 run 控制项通过了原生比较和独立的 MuPDF 1.28.5 与 Poppler 阅读器检查,记录见 DA 主题

Redact 回退只显示预览轮廓,不会移除或涂黑页面内容

静态图标样式和文本布局在不同处理器之间可能不同;独立公式和单独的 MuPDF/Poppler 观察保留在 Tests/Linux/HeadlessAnnotationFallback.en-us.md

渲染器与格式背景见原生 Cairo 渲染和 ISO 32000-2 注释勘误

连续轮廓构造、Unicode 内容边界和常规验收入口见原生云状注释边框