原生云状注释边框
HPDFRenderHeadlessPagePNG 为没有 normal 外观的 Square、Circle、Polygon 和 FreeText 注释合成临时云状边框
提供了 normal 外观时仍以其优先,源 PDF 不会被加入生成的 AP、字体或图形状态资源
连续轮廓
BE 字典选择 S=C 和 0 到 2 的 intensity I,标准默认值为 0;按 ISO 32000-1 Table 167 的要求,BS 宽度和 dash 图案保持有效
云状轮廓是一条闭合的三次 scallop 轮廓,带环绕感知的外法线、有界的曲线路径扁平化和确定性的周长间距
矩形和椭圆保留 RD 几何;多边形消费 Vertices 或 line/cubic Path 操作,包括顺时针、逆时针和凹多边形
描边与填充颜色、CA/ca 不透明度、页旋转、UserUnit 和注释 Form BBox 保持有效;零 intensity、零宽度和缺失描边颜色走普通外观路径
FreeText 使用既有的 Unicode 布局构建器,内容边界从云状内沿墨迹边界内缩,不改动源 RD
限制与验收
轮廓存储、细分深度、操作数、token、解码字节、工作内存和输出字节都有界;取消和渲染失败会保留目标字节和源对象
普通的非 GUI 入口和固定的几何验收公式记录在 Tests/Linux/HeadlessCairoCloudAnnotations.en-us.md
独立解析伴随项覆盖多个尺度下的宽度、intensity、dash、不透明度、旋转和 UserUnit;由于标准并未规定精确的 scallop 样式,MuPDF 和 Poppler 的实际证据保持独立
普通 missing-appearance 夹具为 PDF 1.7,PDF 2.0 Path 夹具则专门演练 missing-appearance 恢复
内嵌 CFF 默认字体、额外的 FreeText DA 操作符和精确的小数三角形文本覆盖仍是独立工作
生成的注释字体视图在每个注释内共享同一份不可变、设过预算的解码缓冲,而重复的字体解析仍会预留其临时工作内存并轮询取消