RedactRegion
Page manipulation
Description
با ویرایش جریان محتوای صفحه، متن، مسیرهای برداری و اشیاء تصویر XObject را که ناحیه ترسیم آنها با مستطیل تلاقی دارد به طور واقعی حذف میکند تا گلیفها، بردارها و بایتهای تصویر زیربنایی از بین بروند و قابل بازیابی نباشند؛ این کار به طور اساسی با MaskRect متفاوت است که فقط یک مستطیل کدر روی محتوا رسم میکند (بایتهای اصلی باقی میمانند و قابل استخراج هستند)
متد برای هر لایه محتوا، جریان را پارس میکند، CTM را ردیابی میکند (با رعایت cm/q/Q)， دستوراتی که جعبه محدودکننده تغییر شکل یافته آنها با ناحیه تلاقی دارد را شناسایی کرده و آنها را حذف میکند； رفتارهای اختیاری کنترل شده توسط Options: ترسیم یک کادر پر شده مشکی روی ناحیه و صادر کردن یک یادداشت استاندارد /Subtype /Redact
محدودیتها: ردیابی CTM برای تبدیلات برشیافته/چرخیده تقریبی است (مقیاسهای خطی و خط مبنای همانی دقیقاً مدیریت میشوند)；عرض متن از تعداد گلیفها و اندازه فونت تخمین زده میشود زیرا جریان محتوا به تنهایی معیاری به همراه ندارد；مکانیابی Image XObject به صورت مربع واحد تبدیل شده توسط CTM تقریب زده میشود
Syntax
Delphi
Function TPDFlib.RedactRegion(Page: Integer; Left, Top, Width, Height: Double; Options: Integer): Integer;Parameters
| Page | شماره صفحه مبتنی بر 1 |
|---|---|
| Left, Top | گوشه بالا و سمت چپ ناحیه بر حسب واحدهای اندازهگیری فعلی (مبدأ بالا و چپ) |
| Width, Height | اندازه ناحیه در واحدهای اندازهگیری فعلی |
| Options | 0 = حذف + پر کردن با رنگ سیاه + یادداشت Redact؛ 1 = فقط حذف؛ 2 = حذف + یادداشت Redact (بدون پر کردن) |
Return values
| >= 0 | تعداد محدودههای دستور حذفشده در تمام لایههای محتوا (0 به معنای عدم وجود تلاقی است) |
|---|