ValidatePdfR - TPdf - PDFium Delphi Component

元件: TPdf · 單元: PDFium

檢查使用中 PDF 是否符合 PDF/R-1 的檔案、中繼資料、點陣內容、條帶幾何、色彩、解析度與壓縮要求

Syntax

function ValidatePdfR: TPdfRValidationResult; overload;
function ValidatePdfR(const Options: TPdfRValidationOptions): TPdfRValidationResult; overload;

Description

ValidatePdfR 結合原始檔案檢查與即時的 PDFium 頁面物件走訪，以對應 ISO 23504-1:2020

%PDF-raster-x.y 標記、允許的檔頭、物件串流禁令、目錄與 Info 字典白名單、XMP 中繼資料、必要的日期，以及 trailer 的 /ID
啟用加密設定檔強制時，檢查 PDF 2.0 加密字典是否使用支援的 /V 與 /R 設定檔
預設要求恰好一條全頁點陣條帶，且不得含有文字、路徑、Form XObject 或漸變內容
允許的色彩模型、位元深度、篩選器鏈、CCITT 參數、DCT 限制，以及有效的水平與垂直解析度

TPdfRValidationOptions.Default 檢查 72 至 2400 DPI、允許 0.5 點的幾何容差、要求全頁條帶，並強制使用加密的 PDF 2.0 設定檔

結果是一筆 TPdfRValidationResult 記錄：

Conformance — prc1（找到 PDF/R-1 標記）、prcNone（沒有標記）或 prcUnknown（剖析失敗或文件未啟用）
Issues — TPdfRValidationIssues 集合，涵蓋檔案標記、中繼資料、加密設定檔、僅限點陣的內容、幾何、色彩、解析度與壓縮參數
IsCompliant — 當 Conformance 是實際的 PDF/R 等級且 Issues 為空時傳回 True

此方法為唯讀，並會在驗證後還原呼叫端原本的使用中頁面

Remarks

在具有有效 xref 鏈的未加密文件上，原始檔案檢查會以有界的稀疏讀取解析作用中的字典與中繼資料，並以固定大小的視窗掃描檔尾標記；加密與不支援的結構仍走相容性路徑
版本標記搜尋仍容許有效標記出現在所建議的 trailer 位置之外
在未啟用的文件上呼叫 ValidatePdfR 會傳回 prcUnknown 與空的問題集合
頁面影像資訊來自原生中繼資料與物件邊界，不會解碼或複製影像內容位元組

Example

uses System.TypInfo;

var
  Outcome: TPdfRValidationResult;
  Issue: TPdfRValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\scan.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfR;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfRConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfRValidationIssue), Ord(Issue)));
end;

ValidatePdfR 方法

元件: TPdf · 單元: PDFium

Syntax

Description

Remarks

Example

See Also