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以目前測量單位表示的區域大小
Options0 = 移除 + 黑色填充 + Redact 註解;1 = 僅移除;2 = 移除 + Redact 註解 (無填充)

傳回值

>= 0所有內容圖層中移除的指令範圍數量(0 表示沒有相交)