PDFium Delphi Component 元件庫

產品概覽

PDFium Delphi Component 是一套完整的專業級元件庫，為 Delphi 與 C++Builder 應用程式帶來強大的 PDF 處理與檢視能力。它使用 PDFium 算繪引擎進行頁面算繪與文件讀取，並以 Object Pascal 實作該引擎未提供的一切

這個區別在評估本元件庫時非常重要。PDFium 負責繪製頁面、擷取文字並讀取既有結構；它無法簽署文件、寫入加密、驗證 PDF 標準，也無法輸出線性化或增量修訂。PDFium Delphi Component 隨附約 115,000 行 Object Pascal、橫跨 55 個單元，其中超過 62,000 行位於 36 個在 PDFium API 中完全沒有對應物的單元 — 密碼學、簽章、加密、標準一致性、PDF 序列化、表單資料交換、版面配置與文字塑形。以上全部以原始碼形式交付

本元件庫由三個註冊元件組成：負責文件處理與操作、具 475 個公開成員的 TPdf；負責互動式視覺呈現、具 152 個公開成員的 TPdfView；以及負責頁面導覽的 TPdfThumbnailView。無論您是要打造簡單的 PDF 檢視器、簽署文件工作流程、封存轉換管線，還是完整的文件管理系統，PDFium Delphi Component 都能提供所需的工具與彈性

引擎之外

以下能力在 PDFium C API 中沒有對應物。每一項都由 PDFium Delphi Component 以 Object Pascal 實作，對照已發布的 ISO、ETSI、IETF 或 FIPS 條款驗證，並以原始碼形式提供

數位簽章 — PAdES

完整的簽署能力，而不只是讀取簽章。PDFium 只能回報簽章字典存在；PDFium Delphi Component 能夠建立它

基線等級：依 ETSI EN 319 142-1 V1.2.1 的 B-B、B-T、B-LT 與 B-LTA，透過 SignPades、SignPadesToStream 與 SignPadesBytes 提供
簽章容器：依 RFC 5652 建置的 CMS / CAdES SignedData，附該設定檔要求的簽署屬性 — content-type、message-digest、signing-certificate-v2 與 commitment-type-indication
時間戳：RFC 3161 TimeStampReq / TimeStampResp 用戶端，採 WinHttp 傳輸，並將權杖嵌入為 signature-time-stamp 未簽署屬性
長期驗證：注入 Document Security Store，含 /Certs、/OCSPs 與 /CRLs、每個簽章專屬的 VRI 字典，以及 /Extensions /ESIC 標記
封存時間戳：含 /SubFilter /ETSI.RFC3161 且涵蓋整個檔案的 Document Time-stamp 字典，用於 B-LTA
金鑰存取：支援 RSA-PSS、RSA PKCS#1 與 ECDSA 的 Windows CNG 後端，置於任何其他後端都能實作的 ICmsSigner 介面之後
遠端與 HSM 簽署：PreparePadesRemoteSignature 與 CompletePadesRemoteSignature 將操作拆開，讓私鑰可以留在遠端服務或硬體模組內
驗證：ValidatePades 回報文件達到的最高基線等級與條款級問題代碼；ValidatePadesTrust 與 ValidatePadesTrustAsync 再加上憑證鏈信任檢查
歐洲信任清單：經過身分驗證的 ETSI 信任清單快照，提供含總和檢查的離線快取、由呼叫端自主的更新、最新的信任錨點，以及不需在驗證器內存取網路的合格服務評估
封存整合：SignPadesWithPdfA 依 EN 319 142-1 Annex A.7 在單一呼叫中轉換為 PDF/A-4 並完成簽署

加密與文件完整性

PDFium 能開啟加密檔案，但不會寫入加密。PDFium Delphi Component 依 ISO 32000-2 及其技術規範實作寫入端

PDF 2.0 AES-256：SaveAsEncrypted 支援 V=5 / R=5 / R=6 金鑰推導，含演算法 2.B 的雜湊迭代，以及 /O /U /OE /UE /Perms 字典項目
全文件掃描：串流與字面字串加密，附正確的 /Length 修正與重建的交互參考表
AES-GCM：ISO/TS 32003 V=6 / R=7 認證加密，含 AESV4 字串與串流的認證解密
PDF MAC：ISO/TS 32004 獨立 /AuthCode 權杖 — CMS AuthenticatedData，附 HKDF 金鑰推導、金鑰包裝與 HMAC 驗證
加密修訂：增量 R5、R6 與 R7 更新會沿用既有的安全性字典、加密已變更的字串與串流、保留物件世代，並驗證或更新 PDF MAC 驗證
基礎元件：CBC 與 GCM 模式的 AES-128/256、SHA-256/384/512、SHA-3、HMAC 與 ASN.1 DER 讀寫，全部為純 Object Pascal 且無外部 C 相依性，並對照 FIPS 197、FIPS 180-4 與 NIST SP 800-38D 已發布的測試向量驗證

標準一致性

六個 ISO 標準家族，每個都有回報條款級結果代碼的驗證器，以及對應的儲存或標記注入路徑

PDF/A：ISO 19005 第 1 至 4 部 — 包括以 PDF 2.0 為基礎的 A-4 基準、A-4f 與 A-4e 設定檔 — 涵蓋 output intents、XMP 識別、字型嵌入、RoleMap 與 ParentTree 結構、Annex C 實作限制與禁止的動作
PDF/X：ISO 15930 從 X-1a 到以 PDF 2.0 為基礎的 X-6，涵蓋 output intent 形式、以設定檔閘控的透明度與色彩空間限制，以及 TrimBox / ArtBox / BleedBox 幾何
PDF/UA：ISO 14289-1，涵蓋表格與清單結構、標題模型、RoleMap 解析、未標籤的真實內容、Artifact 包含關係、物件範圍 Unicode 與 ActualText 擷取、TrueType 與複合字型編碼，以及註解豁免
PDF/E：ISO 24517-1，包括內嵌 sRGB output intent 注入與工程文件字型規則
PDF/VT：ISO 16612-2 VT-1 與 VT-2、DPart 階層、文件部分中繼資料，以及 VT-2s 多部分 MIME 串流封裝
PDF/R：ISO 23504-1，強制每頁單一條帶影像、允許的編碼清單，以及加密/版本一致性
預檢：跨標準的報告彙總器，可匯出 TXT、HTML、Markdown、JSON、CSV、SARIF 2.1.0、JUnit XML 與 NDJSON，附穩定的 SHA-256 報告指紋，以及可透過結束代碼閘控 CI 的命令列執行器

PDF 序列化與修訂

引擎只提供一種循序的全檔儲存。應用程式經常需要更多，因此 PDFium Delphi Component 在引擎的語意輸出之上自行寫入修訂

線性化輸出：SaveAsLinearized 產生 Fast Web View 檔案，附首頁群組、兩個交互參考節區，以及 Annex F 的頁面偏移與共用物件提示表
物件打包：SaveAsObjectStream 以頁面局部排序與完整的 type-2 交互參考涵蓋，將合格物件分組進 /ObjStm
增量修訂：BeginIncrementalSave 與 CommitIncrementalSave 對加密或未加密來源只附加已變更與新增的間接物件，逐位元組保留先前的輸出及 /Prev、/Encrypt、/Info 與永久的 /ID；沒有變更的提交不會讓檔案增長
修復：SaveAsRepaired 寫出單一修訂副本，並在交付前以獨立的嚴格載入重新驗證
載入原則：嚴格、相容與復原模式，附結構化診斷，回報重建路徑、損毀位移、衝突修訂與預算狀態
原生版本查詢：TPdf.PdfVersion 重複使用 PDFium 剖析器狀態，僅執行八位元組標頭防護檢查，而不重新剖析來源文件
工作儲存：TPdfRandomAccessStore 讓中繼資料保持在記憶體中直到 SaveMemoryLimit，之後遷移到獨佔的關閉時刪除暫存檔；核心儲存後處理對三個工作區採用同一原則，而預設 open-action 與 page-label catalog 更新則使用有界視窗與稀疏索引

PDFium 未公開的內容服務

XFDF 與 FDF：依 ISO 19444-1 與 ISO 32000-1 §12.7.11 匯入匯出表單欄位值與 18 種註解子類型，完全以 Pascal 在元件自身的資料模型上序列化
XMP：具型別容器的封包讀取器與寫入器，供每個標準設定檔使用
關聯檔案：附加到 catalog 或目標頁面的 ISO 32000-2 §7.11.4 /AF 陣列，含 Table 45 的八種關係值
OCR 整合：IPdfOcrProvider 接受任何辨識引擎 — 元件提供頁面點陣圖並寫入產生的可搜尋文字層，附每頁狀態與既有文字跳過
結構化文字與表格：GetStructuredText 從字元幾何與 Tagged PDF 語意建立頁面/區塊/行/樣式化 span 階層；ExtractTables 與 ExtractDocumentTables 偵測有框線與以空白對齊的表格、保留合併儲存格、評估信心度並輸出 CSV 或 JSON
語意重排：BuildReflowDocument 將固定版面的 PDF 轉換為節點樹，其安全的 HTML 輸出會保留標題、段落、清單、圖片、頁面區段與表格跨距
版面與文字度量：版面建構器具備段落不分頁、與下段同頁、孤行、寡行與明確分頁限制、跨頁表格，以及具備有界 LRU 具體化的磁碟後援分頁命令儲存；MeasureText 與 WrapText 提供換行，而不對頁面添加任何內容
文字塑形：針對右至左與複雜文字書寫系統的字形級塑形支援
ToUnicode CMap 產生：缺少它時，CID 字型文字可以正確顯示，卻無法複製、搜尋或朗讀
有界串流檢查：TPdfStreamInspector 在明確的來源、原始、解碼、膨脹比與串流數量預算下解碼任意串流物件，傳回結構化狀態，而不會在惡意檔案上耗盡記憶體

核心元件

TPdf 元件 — 文件處理引擎

TPdf 是 PDF 處理系統的核心，負責所有文件層級的操作，包括載入、儲存、文字擷取、表單處理與中繼資料管理

文件管理：支援從檔案、串流或記憶體緩衝區開啟
文字處理：進階文字擷取與搜尋能力
表單處理：含 JavaScript 的完整互動式表單支援
安全性：支援密碼保護 PDF 與權限管理、PDF 2.0 AES-256 加密寫入，以及 PAdES 數位簽署
標準：PDF/A、PDF/X、PDF/UA、PDF/E、PDF/VT 與 PDF/R 驗證，附對應的儲存與標記注入輔助
中繼資料存取：完整的文件屬性、XMP 封包與資訊讀取

TPdfView 元件 — 互動式檢視控制項

一個功能完備的視覺化控制項，提供具有完整使用者互動能力的豐富 PDF 檢視體驗

高品質算繪：最佳化的顯示輸出，支援多種算繪模式
互動式導覽：縮放、捲動、旋轉與頁面導覽
文字選取：選取、複製並處理文字內容
註解顯示：檢視並與 PDF 註解互動
滑鼠與鍵盤：完整的輸入裝置支援，含座標對應

主要功能與能力

文件處理

支援從檔案、串流、記憶體緩衝區或透過 LoadCustomDocument 使用隨選 TStream 介面卡載入 PDF 文件，並提供相容、嚴格與復原原則及結構化 xref 診斷
以 SaveAsRepaired 建立經獨立嚴格驗證的單一修訂修復副本
使用多種選項儲存與匯出文件（增量儲存、移除安全性、明確指定 PDF 版本目標）
PDF 版本合規性驗證器會拒絕較選定目標（PDF 1.0 - 1.7）更新的功能
透過 SaveAsPdfA / SaveAsPdfAToStream 建立 PDF/A-1b，可使用內建 sRGB ICC 設定檔，也支援自訂設定檔
透過 ValidatePdfA 與唯讀 PdfAConformance 屬性進行 PDF/A 驗證
處理密碼保護與加密 PDF
文件中繼資料與屬性管理
頁面組合：MergeFiles（有界來源批次合併）、ImportPagesByIndex（子集匯入）、ImportNPagesToOne（N-up 拼版）、MovePages（原地重排）
Form XObject 頁面重複使用：透過 CreateXObjectFromPage 與 InsertFormObjectFromXObject 將單一頁面戳印到多個頁面
書籤與目的地支援
表單扁平化：依欄位值重新產生外觀串流（/AP），然後將註解與表單控制項燒入靜態頁面內容

文字與內容操作

保留格式資訊的進階文字擷取
具多項選項的強大文字搜尋
字元層級的文字分析與定位
字型資訊與屬性存取
文字選取與剪貼簿操作
多語言與 Unicode 支援

互動式表單與註解

完整的互動式表單欄位支援
文字欄位、核取方塊、選項按鈕、下拉式方塊
表單驗證與 JavaScript 執行
註解顯示與互動
連結註解與網頁連結
數位簽章：PAdES B-B 至 B-LTA 簽署、RFC 3161 時間戳、遠端 / HSM 簽署與信任驗證

視覺繪製與顯示

高品質反鋸齒算繪，以零複製方式直接寫入目標 DIB 緩衝區
透過 RenderPageProgressive 與 IPdfCancellationToken 提供可取消的漸進式繪製
透過 TPdfProgressiveDocument 進行原生漸進下載，包括稀疏位元組範圍提示、優先順序範圍排程、有界重試、取消，以及文件、表單與頁面可用性閘控
透過 SaveAsLinearized 輸出 Fast Web View，包括首頁群組、兩個交互參考節區，以及 Annex F 的頁面偏移與共用物件提示表
透過 SaveAsObjectStream 進行現代 PDF 1.5+ 物件打包，包括有界的 ObjStm 群組、頁面局部排序與完整的 type-2 xref 涵蓋
透過 BeginIncrementalSave 與 CommitIncrementalSave 進行髒物件修訂工作階段，包括加密前綴保留、沿用的安全性參數、無操作提交、嚴格重新開啟驗證、持久的附屬檔案、原子取代、復原，以及每次提交的統計
透過 TPdfRandomAccessStore 與 SaveMemoryLimit 提供有界隨機存取工作儲存，包括安全的暫存檔溢流、定位 I/O 與每次儲存的峰值診斷
多種顯示模式（單頁連續、雙頁連續、含封面雙頁）
FitMode 決定頁面於檢視區中的呈現方式（手動縮放、實際大小、符合頁面、符合寬度），於 Resize 與翻頁時自動重新套用
PageColor 將算繪的 PDF 頁面背景與外層控制項的 Color 解耦，適用於深色模式檢視器
透過 HighlightSearchText 與 ClearHighlight 標示搜尋結果
可選的投影陰影（PageShadowSize / PageShadowColor）與頁面邊框（PageBorderColor）
具動作允許清單的安全連結點按處理（LinkOptions），以及 OnAnnotationLinkClick / OnWebLinkClick 事件
使用者輸入鎖定（AllowUserPageChange、ChangePageOnMouseScrolling、AllowUserTextSelection），適合自助服務終端與唯讀嵌入
透過 TPdfThumbnailView 側邊面板元件進行縮圖導覽
LCD 最佳化文字算繪
多種可選 PDFium 列印模式（EMF、純文字、PostScript Level 2 / 3、直通、影像遮罩、Type 42）的列印級輸出
自訂色彩與灰階算繪

對開發人員友善的特性

用於客製化的完整事件系統
螢幕與 PDF 之間的精確座標對應
豐富的屬性與方法 API
具屬性編輯器的設計時期支援
在適用之處採用執行緒安全操作
面向大型文件的高效率記憶體處理

技術規格

項目	說明
繪製引擎	Google PDFium — 業界標準、久經考驗的 PDF 引擎
PDF 支援	PDF 1.0 至 1.7 版本，含加密與密碼保護檔案
平台相容性	Windows 32 位元與 64 位元應用程式
IDE 支援	Delphi XE5 / C++Builder XE5(RAD Studio XE5)至 Delphi/C++Builder 13.1 Florence(RAD Studio 13.1)、Lazarus 3.8+
字元編碼	完整 Unicode 支援，多語言文字處理
記憶體管理	面向大型文件最佳化，資源使用高效率
執行緒安全性	單執行緒設計(遵循 PDFium 規範)

架構設計

PDFium Delphi Component 採用分層架構模式，清楚劃分關注點，並將程式碼可重複使用性最大化：

分層架構

層級	檔案	職責
VCL 元件	PDFium.pas、FPdfThumbnail.pas	具設計時期支援的 Delphi VCL 元件(TPdf、TPdfView、TPdfThumbnailView)
API 繫結	FPdfView.pas、FPdfDoc.pas、FPdfText.pas、FPdfEdit.pas、FPdfAnnot.pas、FPdfFormFill.pas、FPdfPageOps.pas、FPdfAttachment.pas、FPdfSignature.pas、FPdfStructTree.pas、FPdfDataAvail.pas、FPdfExtensions.pas、FPdfFWLEvent.pas、FPdfCompress.pas、FPdfUtils.pas	PDFium DLL 呼叫所使用的函式指標宣告
PDF/A 流水線	FPdfPdfa.pas	PDF/A-1b 建立(XMP 注入、sRGB ICC OutputIntent、catalog 更新)與驗證(合規層級偵測、問題列舉)
非同步基礎設施	FPdfAsync.pas	IPdfCancellationToken / IPdfCancellationTokenSource、PdfNoCancellationToken 單例，以及面向長時間算繪與匯出工作的 TPdfFuture<T> 輔助類別
幾何輔助	FPdfMatrix.pas	FS_MATRIX 的物件導向封裝，提供 Translate、Scale、Rotate、Flip、Skew、Multiply 等輔助方法
頁面操作	FPdfPageOps.pas	FPDF_ImportPagesByIndex、FPDF_ImportPages、FPDF_ImportNPagesToOne、FPDF_MovePages 的封裝、可擴充的檔案後援批次排程，以及 Form-XObject 輔助(CreateXObjectFromPage / InsertFormObjectFromXObject)
縮圖側邊面板	FPdfThumbnail.pas	TPdfThumbnailView — 可捲動的逐頁縮圖面板，具懸停、選取與 OnPageClick 導覽
原生引擎	DLLs\Win32\|Win64\pdfium.dll 與 pdfium.v8.dll	Google PDFium 原生算繪引擎，可選用啟用 V8 的版本

元件階層

TPdf(TComponent)— 用於 PDF 文件操作的非視覺元件
TPdfView(TScrollingWinControl)— 繼承捲動與焦點能力的視覺化控制項
TPdfThumbnailView(TCustomControl)— 與 TPdf 元件連動的可捲動縮圖導覽側邊面板

關鍵設計模式

動態 DLL 載入:PDFium 函式於執行期透過 GetProcAddress 載入
以控制代碼為基礎的資源:PDF 文件、頁面與物件透過不透明的控制代碼管理
事件驅動架構:涵蓋表單互動、翻頁與繪製的豐富事件
以記錄為基礎的型別:複雜資料結構以 Delphi record 形式公開(TBookmark、TDestination、TPdfAnnotation 等)
選用式輔助：FPdfAsync 與 FPdfMatrix 提供取消/future 與變換工具，毋須強行併入主 TPdf 元件

應用情境

商務應用

文件管理系統:檢視、組織並處理 PDF 文件
報表檢視器:顯示產生的報表與商務文件
表單處理:處理互動式 PDF 表單與資料收集
封存系統:存取並顯示歷史 PDF 文件

教育與研究

線上學習平台:顯示課程資料與教科書
研究工具:分析並擷取學術論文中的資料
數位圖書館:瀏覽並搜尋文件館藏
筆記應用程式:對 PDF 內容進行註解與標示

法律與法規遵循

法律文件審閱:檢視合約與法律文件
法規遵循系統:驗證文件完整性與簽章
案件管理:組織並審閱法律文件
稽核工具:處理並分析法規文件

技術與工程

CAD 檢視器:顯示技術圖面與規格
手冊系統:存取維護與操作手冊
品質管制:檢視測試報告與認證文件
專案管理:處理專案文件與計畫

優勢與效益

效能與可靠性

成熟的算繪：頁面算繪使用 Chromium PDF 顯示背後的 PDFium 引擎家族，而其上的所有功能都是 losLab 自己的 Object Pascal 實作
高效能：零複製 DIB 寫入、可取消的漸進式算繪、平行頁面算繪、避免預先記憶體複製的隨選可搜尋載入，以及橫跨保留頁面場景與受管理快照的單一可量化位元組預算
對惡意輸入的穩定性：串流解碼、內容正規化與結構掃描都在明確的來源、輸出、權杖、巢狀與膨脹比預算下執行，因此格式錯誤或蓄意建構的檔案會傳回結構化狀態，而不會耗盡記憶體
可擴展性：可處理小型表單與數 GB 的文件，具備會溢寫至關閉即刪除暫存檔的有界工作儲存

商業價值

快速開發:475 個 TPdf 公開成員與 36 個可立即執行的專案縮短開發時間
簽署與加密單一供應商:PAdES 簽章與 PDF 2.0 加密都是本元件庫的一部分 — 不需另外的簽署 SDK、不需部署 OpenSSL、不需洽談第二份授權
免授權金:無執行時期費用與授權上的複雜性
含原始碼:具備完整的客製化與偵錯能力，下探至密碼學基礎元件 — 它們是純 Object Pascal，沒有需要通過安全審查的外部 C 相依性
長期支援:定期更新與相容性維護，涵蓋 Delphi 與 C++Builder XE5 至 13.1 Florence，以及 Lazarus / Free Pascal

開發體驗

易於整合：直接放置即用的元件，只需極少設定
豐富文件:完整的說明檔案與範例
事件驅動:透過豐富的事件提供靈活的客製化
設計時期支援:屬性編輯器與 IDE 整合

延伸探索

文件首頁 — 網頁導覽進入點
快速入門指南 — 幾分鐘開始執行
安裝說明 — 設定與部署
程式碼範例 — 實務用法情境
完整 API 參考 — 完整元件文件
TPdf 元件 — 文件處理細節
TPdfView 元件 — 檢視控制項細節