原生雲狀註解邊框
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 運算子和精確的小數三角形文字覆蓋仍是獨立工作
相關渲染行為另見註解 fallback 與行標題與浮雕邊框
產生的註解字型檢視在每個註解內共用同一份不可變、設過預算的解碼緩衝,而重複的字型解析仍會預留其暫時工作記憶體並輪詢取消