進階頁面內容 API

PageObjectInfo 傳回單一 TPdfPageObjectInfo 快照，包含控制代碼、物件型別、正常與旋轉邊界、有效矩陣、作用狀態、透明度、填色與描邊顏色、alpha 值、描邊寬度、線條接合、線條端點、虛線陣列與虛線相位

HasRotatedBounds、HasActiveState 與其他 Has* 欄位可區分「原生值無法取得」與「有效的零值」

RotatedBounds 攜帶旋轉後的四邊形，HasLineJoin 與 HasLineCap 把關接合與端點樣式，DashPhase 則偏移虛線圖樣的起點

UpdatePageObject 會把每個選取的欄位套用到同一個原生物件，並只重新產生頁面內容一次

TransformPageObject 對選取的物件組合仿射 FS_MATRIX

• PathInfo 傳回每個路徑線段的填色模式、描邊狀態、線段型別、端點與閉合狀態
• PageObjectClipPath 傳回與頁面物件相關聯的每個剪裁子路徑與線段
• TransformPageObjectClipPath(Index, Matrix) 只轉換該剪裁幾何，頁面物件矩陣維持不變
• FormObjectChildren 傳回 Form XObject 直接子項的詳細快照
• DetachFormObjectChild(FormIndex, ChildIndex) 移除一個子項，並把傳回的 FPDF_PAGEOBJECT 所有權轉移給呼叫端，由呼叫端負責插入或摧毀

• PageObjectMarks、PageObjectMarkedContentID、AddPageObjectMark、SharePageObjectMark、SetPageObjectMarkParam、RemovePageObjectMarkParam 與 RemovePageObjectMark 可檢查、重用與更新標記內容關聯，而不會取代無關的屬性
• TextObjectGlyphOutline 公開字形路徑幾何，而 TextObjectGlyphWidth(Index, GlyphIndex, FontSize) 傳回所要求尺寸下的原生字形推進量
• TextObjectFontSize(Index) 讀取原生文字物件尺寸，SetTextObjectFontSize(Index, FontSize) 則直接編輯尺寸，不必透過矩陣轉換來近似
• GetImageObjectRenderedBitmap(Index) 傳回由呼叫端擁有的點陣圖，其中已由 PDFium 套用影像遮罩、顏色轉換與影像矩陣
• AnnotationObjectCount、AnnotationObjectInfo、AddPathToAnnotation 與 RemoveAnnotationObject 作用於註解外觀物件
• IsAnnotationObjectSubtypeSupported(Subtype) 探測已載入的 PDFium 模組是否支援該子類型的外觀物件擷取、更新與移除
• PerformNamedAction 分派已知的文件動作，OnNamedAction 則回報具名動作回呼

CharacterInfo 傳回填色與描邊顏色、字型名稱、PDF 字型旗標、寬鬆字形邊界、有效矩陣，以及相關聯的文字物件控制代碼

CharacterIndexToTextIndex 與 TextIndexToCharacterIndex 在 PDFium 字元索引與所產生文字流中的索引之間轉換

TPdfAnnotation 透過 HasBorder、BorderHorizontalRadius、BorderVerticalRadius 與 BorderWidth 公開框線半徑與寬度

顏色涵蓋範圍延伸到 ColorAlpha、InteriorColor 與 InteriorColorAlpha，標註中繼資料由 HasAuthor、HasName、HasSubject、HasModificationDate、HasCreationDate 與 HasIcon 把關，墨跡手勢、四點幾何與連結目標則透過 InkList、HasAttachmentPoints、HasLinkUri 與 LinkUri 公開

正常、滑入與按下的外觀串流可透過 HasAppearanceNormal、HasAppearanceRollover 與 HasAppearanceDown 哨兵旗標及其對應的 AppearanceNormal、AppearanceRollover 與 AppearanceDown 字串取得

讀取註解時，這些哨兵旗標識別的是非空的外觀內容：原生 API 對「串流不存在」與「串流為空」回傳同樣的空字串，因此兩者都回報 False，寫回記錄時也不會被更動；呼叫端仍可明確把哨兵旗標設為 True，寫出空的外觀

把更新後的註解記錄指派回 Annotation[Index]，即可寫入選取的框線或外觀值

• ConfigurePdfLibrary、GetPdfLibraryConfiguration 與 PdfLibraryConfigurationSealed 在第一次載入前設定並稽核不可變的處理程序層級原生初始化與沙箱政策
• TPdfLibraryConfiguration 攜帶 UserFontPaths、V8Isolate、V8EmbedderSlot、V8Platform、Renderer、FontBackend、BrotliEnabled、IsolatePerDocument 與 AllowMachineTime，並透過 TPdfRendererPreference（prpDefault、prpAgg、prpSkia）與 TPdfFontBackendPreference（pfbpDefault、pfbpFreeType、pfbpFontations）只選取所要求設定需要的原生欄位
• PdfDefaultTtfMapCount 與 TryGetPdfDefaultTtfMapEntry 以受檢查的索引存取方式列舉原生預設字型替代
• TPdfDefaultTtfMapEntry 從單一索引對應項複製字體名稱、字元集與原生平台字型中繼資料
• FormFieldZOrderAtPoint 與 LinkZOrderAtPoint 傳回最前端的原生 Z 軸順序，沒有目標時傳回 -1
• TryGetAnnotationFileAttachment 在原生註解控制代碼仍有效時，複製有界限的檔案中繼資料與承載
• TPdfAnnotationAttachment 獨立於頁面與註解控制代碼，自行擁有該複製的中繼資料與承載
• GetLinkedAnnotationIndex 與 GetLinkedAnnotationChain 解析 Popup 與 IRT 關聯，並提供懸空參照、循環與深度保護
• TPdfAnnotationRelationship 選擇 Popup（parPopup）或 IRT（parInReplyTo）關聯，TPdfAnnotationSubtypes 則儲存焦點政策的子類型陣列
• GetAnnotationDictionaryValue 與 GetAttachmentDictionaryValue 在傳回支援的純量值之前，會先回報確切的原生值種類
• TPdfDictionaryValueKind 保留原生物件類別（pdvkUnknown、pdvkBoolean、pdvkNumber、pdvkString、pdvkName、pdvkArray、pdvkDictionary、pdvkStream、pdvkNull、pdvkReference），TPdfDictionaryValue 以 NumberValue 與 StringValue 攜帶支援的數值或字串純量，並以 HasScalarValue 作為明確的哨兵
• SetFocusableAnnotationSubtypes 與 GetFocusableAnnotationSubtypes 透過原生表單控制代碼控制鍵盤焦點資格
• TPdfStructureElement.Attributes 是 TPdfStructureAttributeValues 平面樹，其 TPdfStructureAttributeValue 節點透過 AttributeIndex 回連到所屬的屬性字典，並以 BlobValue 保留具型別的巢狀值與無損二進位資料
• TPdfView.FormFieldZOrderAt、TPdfView.LinkZOrderAt 與 TPdfView.ReplaceFormTextAndKeepSelection 透過視覺控制項公開對應的座標轉換與保留選取範圍的表單作業

• ThumbnailRawData 傳回濾波器解碼前的內嵌縮圖串流
• ThumbnailDecodedData 傳回濾波器解碼後的內嵌縮圖串流
• TransformPageContent 轉換並剪裁所有頁面物件、重新產生頁面，並重新載入其衍生的控制代碼
• TransformPageAnnotations 對目前頁面上的所有註解套用相同的仿射座標模型

RenderPageWithMatrix 接受可逆的 FS_MATRIX 與裝置座標下的剪裁矩形

接收呼叫端自有 TBitmap 的多載會直接算繪到相容的 32 位元 DIB，只有在外部 PDFium 點陣圖無法建立時，才回退為單次複製

矩陣算繪會繪製頁面內容與透過算繪旗標選取的非互動式註解，但不會呼叫表單填寫覆疊算繪器