FPdfRedaction - PDFium Delphi Component

FPdfRedaction 提供 TPdf.SaveAsRedacted 使用的保守來源檢查與幾何操作；高階方法負責交易、註解處理、不透明疊圖、內容重新產生、清理與資源裁除

輔助功能修改呼叫端隔離交易副本中的原生物件，遇到不支援幾何或預算耗盡時拋出 EPdfRedactionGeometry；單靠它們無法完成安全匯出

公開宣告

type
  EPdfRedactionGeometry = class(Exception);
  TPdfRedactionGeometryOptions = record
    MaxFormDepth, MaxObjects, MaxPathSegments, MaxFragments: Integer;
    MaxImagePixels, MaxGeometryOperations: Int64;
    CurveTolerance: Double;
    class function Default: TPdfRedactionGeometryOptions; static;
  end;
  TPdfRedactionGeometryReport = record
    ExpandedFormCount, ScannedChildCount, ClippedPathCount: Integer;
    FlattenedCurveCount, GeneratedPointCount, FragmentCount: Integer;
    MaskedImageCount: Integer;
    ScannedPixelCount, MaskedPixelCount, PixelIntersectionTestCount: Int64;
    GeometryOperationCount: Int64;
  end;

procedure ValidateDetailedRedactionSource(Source: TStream);
procedure ValidateDetailedRedactionText(PageObject: FPDF_PAGEOBJECT);
procedure ExpandRedactionForms(Page: FPDF_PAGE;
  const Options: TPdfRedactionGeometryOptions;
  var Report: TPdfRedactionGeometryReport);
procedure ClipRedactionPath(Page: FPDF_PAGE; PageObject: FPDF_PAGEOBJECT;
  ObjectIndex: Integer; const Redactions: array of FS_RECTF;
  const Options: TPdfRedactionGeometryOptions;
  var Report: TPdfRedactionGeometryReport);
procedure MaskRedactionImage(Document: FPDF_DOCUMENT; Page: FPDF_PAGE;
  PageObject: FPDF_PAGEOBJECT; ObjectIndex: Integer;
  const Redactions: array of FS_RECTF;
  const Options: TPdfRedactionGeometryOptions;
  var Report: TPdfRedactionGeometryReport);

座標與支援的幾何

所有遮除矩形與曲線容差使用 PDF 使用者空間的點；路徑點先轉換至頁面空間再裁切，ObjectIndex 是原始從零起算的原生頁面物件索引，用來保留繪製順序

ExpandRedactionForms 遞迴分離文字、路徑與影像子物件，組合非奇異的執行個體變換與原生裁切，並在原始 Form 位置插入展開物件；各共用執行個體獨立展開，避免原地修改原始共用 Form 串流
ClipRedactionPath 要求無筆畫的實心填色路徑，以有上限的細分深度展平三次曲線、扣除矩形切割區，並在保留的輪廓間維持非零環繞或奇偶填色規則
路徑切割區擴大 CurveTolerance + 0.001 PDF 點；容差限制曲線近似誤差，也可能移除要求矩形外的少量額外邊緣
MaskRedactionImage 接受包括旋轉、鏡射與傾斜的非奇異仿射變換，以及受支援的解碼 Gray、BGR、BGRx 或 BGRA 樣本；保留解碼解析度並建立全新取代影像
每個像素的變換後四邊形，只要接觸擴大 0.001 PDF 點的遮除矩形，色彩與 Alpha 位元組都會清空；保留像素維持解碼後色彩樣本
ValidateDetailedRedactionText 要求一般填色文字才能部分保留；字元對應與片段重建仍由高階方法負責

展開及部分幾何會拒絕透明或混合狀態、不支援的子類型、奇異矩陣、圖樣填色，以及複雜或非冗餘裁切路徑；受支援的冗餘矩形裁切必須涵蓋完整物件邊界

選項與累計報告

選項	預設	意義
`MaxFormDepth`	`32`	巢狀 Form 展開深度
`MaxObjects`	`1000000`	頁面列舉及累計展開子物件上限
`MaxPathSegments`	`262144`	每條路徑輸入線段與累計產生路徑點
`MaxFragments`	`1000000`	保留矩形區域與累計取代片段
`MaxImagePixels`	`16777216`	累計處理的解碼影像像素
`MaxGeometryOperations`	`67108864`	累計幾何與像素交集工作
`CurveTolerance`	`0.01`	以 PDF 點表示的三次曲線展平容差

請以 TPdfRedactionGeometryOptions.Default 初始化選項，在交易開始前將報告歸零一次；輔助功能呼叫間使用同一份報告，讓產生點、影像像素、片段與操作預算累計

ExpandedFormCount 與 ScannedChildCount 描述展開工作，走訪數包含根 Form 執行個體與子物件；ClippedPathCount、FlattenedCurveCount 及 GeneratedPointCount 描述路徑工作，包含中間裁切點；MaskedImageCount、ScannedPixelCount、MaskedPixelCount 及 PixelIntersectionTestCount 描述影像工作

FragmentCount 計算取代物件，並非多邊形輪廓或像素；GeometryOperationCount 累計有上限的輔助處理工作。例外留下的報告可能描述已捨棄交易副本中的部分工作

來源檢查與匯出邊界

ValidateDetailedRedactionSource 在修改前檢查使用中的物件與解碼內容；TPdf.SaveAsRedacted 在所有處理模式都會呼叫，包括整個物件移除與較簡單的部分保留模式

拒絕已簽署來源、Tagged PDF 結構、/ActualText 與 /Alt 替代資料、XFA，以及包括 /OCProperties、/OCG、/OCMD 的選用內容語意
拒絕影像遮罩、軟遮罩、轉移函式、半色調與疊印狀態、內嵌影像、文字裁切或未知的 Tr 運算元，以及 scn/SCN 圖樣或特殊色彩空間繪製
檢查的內容串流必須未套用濾鏡，或只使用單一具名 /FlateDecode 濾鏡；解碼上限為每個內容串流 32 MiB、總計 64 MiB
使用中物件讀取器採用預設來源、物件本文、物件串流展開與物件數預算；修改幾何選項不能繞過這些獨立檢查上限

目前模式不重建 Tagged PDF 結構、不保留任意透明效果、不支援任意筆畫或裁切，也不保證無損保留編碼影像；安全輸出需要在重新產生內容後移除原始串流與未使用資源，TPdf.SaveAsRedacted 會完成這些處理

直接呼叫端必須提供隔離文件副本、驗證原生功能及有限的正值預算、失敗時捨棄副本、重新產生修改過的頁面內容，並在匯出之前完成清理與資源裁除

另請參閱

TPdf.SaveAsRedacted, TPdf.SaveAsSanitised, FPdfCompress

有資源上限的遮除幾何輔助功能

公開宣告

座標與支援的幾何

選項與累計報告

來源檢查與匯出邊界

另請參閱