RedactRegion
Page manipulation
Description
Valóban eltávolítja azokat a szövegeket, vektoros útvonalakat és kép XObjects elemeket, amelyek kirajzolt területe metszi a téglalapot, mégpedig az oldal tartalomfolyamának (content stream) szerkesztésével, így a mögöttes glifák, vektorok és képbájtok eltűnnek és nem állíthatók vissza; ez alapvetően különbözik a MaskRect-től, amely csak egy átlátszatlan téglalapot fest a tartalom tetejére (az eredeti bájtok megmaradnak és kinyerhetők)
Minden egyes tartalomréteg esetén a metódus elemzi az adatfolyamot, nyomon követi a CTM-et (tiszteletben tartva a cm/q/Q-t), azonosítja a régiót metsző transzformált határoló dobozú utasításokat, és törli azokat; az Options által vezérelt opcionális viselkedések: fekete kitöltő doboz bélyegzése a régió fölé, és szabványos /Subtype /Redact annotáció kibocsátása
Korlátozások: a CTM követése hozzávetőleges a nyírt/forgatott transzformációk esetén (a lineáris skálák és az identitás alapvonal pontosan kezeltek); a szöveg szélessége a glifák száma és a betűméret alapján becsült, mivel a tartalomfolyam önmagában nem hordoz metrikákat; a kép XObject elhelyezése a CTM által transzformált egységnégyzetként van közelítve
Syntax
Delphi
Function TPDFlib.RedactRegion(Page: Integer; Left, Top, Width, Height: Double; Options: Integer): Integer;Parameters
| Page | Az 1-alapú oldalszám |
|---|---|
| Left, Top | A régió bal felső sarka az aktuális mértékegységekben (bal felső origó) |
| Width, Height | A régió mérete a jelenlegi mértékegységekben |
| Options | 0 = eltávolítás + fekete kitöltés + Redact annotáció; 1 = csak eltávolítás; 2 = eltávolítás + Redact annotáció (nincs kitöltés) |
Return values
| >= 0 | Az összes tartalomrétegből eltávolított utasítástartományok száma (a 0 azt jelenti, hogy semmi sem metszette egymást) |
|---|