PDFiumPas 文件

SaveAsDeduplicated 方法

元件: TPdf · 單元: PDFium

將文件重寫為單一乾淨修訂版本：先清掃無法連通的物件，再將相容的字型、影像與 form XObject 收合到單一共用代表

Syntax

function SaveAsDeduplicated(Stream: TStream; out Report: TPdfDedupReport; AllowSignedDocument: Boolean = False): Boolean;

function SaveAsDeduplicated(const FileName: string; out Report: TPdfDedupReport; AllowSignedDocument: Boolean = False): Boolean;

Description

PDFium 先寫出目前記憶體中文件的非增量副本，接著包裝層執行全文件的可連通性走訪，並如同 SaveAsReachable 一般捨棄每個無法連通的物件

接著對字型、影像與 form XObject 建立指紋：每個候選字典、其完整可連通子圖與原始串流承載都會被遞迴雜湊，因此只有整體內容完全相同時重複項目才會合併

每個指向被合併重複項目的交叉參考都會改寫為存留的代表，而物件編號與世代保持穩定，因此每個存留的交叉參考仍然有效

輸出是不含物件串流與交叉參考串流的單一傳統修訂版本，而重建的 trailer 會延續 /Root、/Info 與 /ID

Policies and limits

TPdfDedupReport 回報保留與修剪的物件數量，以及各類別合併的字型、影像與 form XObject 數量，並附上來源與輸出位元組大小及結構化的失敗訊息
加密文件會被拒絕，因為單一修訂版本的重寫無法遵守加密所依賴的物件編號、位元組範圍與每物件金鑰
簽署文件會被拒絕，除非明確啟用 AllowSignedDocument，因為完整重寫會使既有的簽章位元組範圍失效
候選項目依資源類型分組，因此 8 位元組雜湊碰撞永遠不會將字型與影像或表單收合在一起

Example

Pdf.SaveAsDeduplicated('deduplicated.pdf', Report);
WriteLn('merged ', Report.MergedImageCount, ' images');

See Also

SaveAsReachable, SaveAs, SaveAsNormalizedContent