RedactRegion
頁面操作
描述
透過編輯頁面內容資料流,真正移除繪製區域與矩形相交的文字、向量路徑和影像 XObjects,使底層字形、向量和影像位元組消失且無法復原;這與 MaskRect 截然不同,後者僅在內容頂端繪製一個不透明矩形(原始位元組仍然存在且可以被擷取)
對於每個內容圖層,此方法會剖析資料流、追蹤 CTM (遵循 cm/q/Q)、識別其轉換後邊界框與該區域相交的指令,並將其刪除;由 Options 控制的可選行為:在該區域上蓋上黑色填充方塊,並發出標準的 /Subtype /Redact 註解
限制:對於傾斜/旋轉轉換,CTM 追蹤是近似的(線性縮放和單位基準線是精確處理的);由於僅內容流不包含度量資訊,文字寬度是根據字符數量和字型大小估算的;Image XObject 的放置被近似為由 CTM 轉換的單位正方形
語法
Delphi
Function TPDFlib.RedactRegion(Page: Integer; Left, Top, Width, Height: Double; Options: Integer): Integer;
參數
| Page | 從 1 開始的頁碼 |
|---|---|
| Left, Top | 目前測量單位中區域的左上角(左上角原點) |
| Width, Height | 以目前測量單位表示的區域大小 |
| Options | 0 = 移除 + 黑色填充 + Redact 註解;1 = 僅移除;2 = 移除 + Redact 註解 (無填充) |
傳回值
| >= 0 | 所有內容圖層中移除的指令範圍數量(0 表示沒有相交) |
|---|