原生註解 fallback

HPDFRenderHeadlessPagePNG 為沒有 normal 外觀的受支援註解建構暫時外觀

既有 normal 外觀優先;作用中的畸形外觀仍會明確失敗

來源文件保持不變:產生的串流與字型屬於渲染操作,用後即釋放

幾何與靜態內容

fallback 涵蓋 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 檢查在 fallback 建構之前進行;暫時外觀保留頁裁剪以及既有的檢視/列印、NoZoom 與 NoRotate 幾何規則

行標題與浮雕邊框

行標題經由同一條暫時 Unicode 文字 Form 路徑消費 Cap、CP、CO、Contents、RC 與 DS,實測 Inline 間隙、Top 放置與相對端點的偏移

長標題使用線上方放置;明確段落斷行被保留,空 plain 或 rich 文字讓一般線保持原樣

標題邊界同時保留暫時 Form BBox 與註解矩形;一般頁面內容裁剪不變

矩形斜面與內嵌邊框使用方向相反的明暗條帶,邊框與內部不透明度相互獨立;零寬度與空顏色陣列保留其透明語義

未知的具名邊框樣式使用實線預設值,非名稱樣式仍是畸形輸入

顏色政策、字型生命週期與獨立驗收涵蓋見註解裝飾

FreeText

plain 文字支援 PDFDocEncoding、UTF-16 與帶 BOM 的 UTF-8;XHTML rich text 支援繼承的預設樣式與文字串流 RC 條目

受支援的預設外觀運算子為 Tf、g、rg、k、Tc 與 Tw;Tf 字型大小為零時請求自動貼合

內嵌預設 TrueType 字型使用文件字型位元組;受支援的標準字型與 rich text 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 之外的運算子以及更多 fallback handler 不在這個實作之內;有限的驗收控制項不能確立任意變換後的點陣包絡

Tr4 到 Tr7 使用累積的字形輪廓裁剪;其四個有限的雙 run 控制項通過了原生比較與獨立的 MuPDF 1.28.5 與 Poppler 閱讀器檢查,記錄見 DA 主題

Redact fallback 只顯示預覽輪廓,不會移除或塗銷頁面內容

靜態圖示樣式與文字排版在不同處理器之間可能不同;獨立公式與個別的 MuPDF/Poppler 觀察保留在 Tests/Linux/HeadlessAnnotationFallback.en-us.md

渲染器與格式背景見原生 Cairo 渲染與 ISO 32000-2 註解勘誤

連續輪廓建構、Unicode 內容邊界與一般驗收入口見原生雲狀註解邊框