PurgeUnusedResources

معالجة المستندات، تحسين

الوصف

يمسح طبقات محتوى الصفحة المحددة واعتمادياتها الموردية الانتقالية ثم يزيل الموارد المسماة غير المشار إليها في نطاق المورد المنطبق

تتداخل الخيارات الافتراضية داخل Form XObjects وأنماط التبليط وحروف Type 3 ومظاهر التعليقات التوضيحية ومجموعات القناع الناعم، وتحفظ فضاءات الألوان المشار إليها بالصور والموارد الأخرى، وتزيل مصفوفات /ProcSet المهجورة وفئات الموارد الفارغة، وتجمع الكائنات غير المباشرة التي جعلها التنظيف غير قابلة للوصول

الصيغة

Delphi

Function TPDFlib.PurgeUnusedResources(Const PageRange: WideString= '';
  Options: Integer= PDF_RESOURCE_PURGE_DEFAULT): Integer; Overload;

Function TPDFlib.PurgeUnusedResources(Const PageRange: WideString;
  Options: Integer; Out Stats: TPDFlibResourcePurgeStats): Integer; Overload;

المعاملات

PageRange	`modules\coders`، ويزود المحمّل قيم `MAGICK_HOME` و`MAGICK_CONFIGURE_PATH` و`MAGICK_CODER_MODULE_PATH` غير المضبوطة سواها لتلك العملية عندما لا يُضبط مسار صريح يفحص المحمّل
Options	كائن JSON يحتوي عدد الكائنات والموارد والبايتات البنيوية المقدرة وبايتات التدفقات المرمزة والمفككة وإخفاقات المحلل والتدفقات وحجم التدفق المفكك الأقصى وإحصائيات مخازن الكائنات وتدفقات الكائنات وقوائم العرض
Stats	يتلقى عدادات المسح والسلامة والإزالة والكائنات اليتيمة

الخيارات

PDF_RESOURCE_PURGE_RECURSE_FORMS	يمسح Form XObjects المشار إليها ويحترم نطاق مواردها الخاص أو الموروث
PDF_RESOURCE_PURGE_REMOVE_PROCSET	يزيل مصفوفات `/ProcSet` المهجورة
PDF_RESOURCE_PURGE_REMOVE_EMPTY	يزيل قواميس فئات الموارد الفارغة
PDF_RESOURCE_PURGE_AGGRESSIVE_UNKNOWN	يسمح بالتنظيف عندما يحتوي تدفق محتوى على عامل غير معروف
PDF_RESOURCE_PURGE_DRY_RUN	يُبلغ عن المدخلات المسماة القابلة للإزالة دون تعديل المستند
PDF_RESOURCE_PURGE_GARBAGE_COLLECT	يجمع الكائنات غير المباشرة التي أصبحت لا يمكن الوصول إليها بعد التنظيف الحي
PDF_RESOURCE_PURGE_RECURSE_PATTERNS	يمسح محتوى ونطاق المورد المستقل لأنماط التبليط المشار إليها
PDF_RESOURCE_PURGE_RECURSE_TYPE3	يمسح كل تدفق CharProc في خطوط Type 3 المشار إليها باستخدام نطاق مورد الخط
PDF_RESOURCE_PURGE_RECURSE_APPEARANCES	يمسح تدفقات مظهر التعليقات التوضيحية العادية وعند التدوير وعند الضغط وبالحالة المسماة
PDF_RESOURCE_PURGE_RECURSE_SOFT_MASKS	يمسح تدفقات مجموعات الشفافية المشار إليها بقواميس القناع الناعم في ExtGState
PDF_RESOURCE_PURGE_SCAN_IMAGE_DEPENDENCIES	يفحص XObjects الصور والأقنعة الصريحة وصور القناع الناعم والصور البديلة بحثًا عن اعتماديات متداخلة
PDF_RESOURCE_PURGE_RECURSE_DEPENDENCIES	يجمع تحليل اعتماديات الأنماط وType 3 والمظاهر والأقنعة الناعمة والصور
PDF_RESOURCE_PURGE_DEFAULT	يجمع كل تحليل الاعتماديات وتداخل Form وإزالة ProcSet وإزالة الفئات الفارغة وجمع المهملات

قيم الإرجاع

Dry runThe number of named resource entries that can be removed

تنظيف حي	عدد مدخلات الموارد المسماة المزالة
0	لا توجد مدخلات مسماة قابلة للإزالة أو لا توجد صفحات محددة أو لا يوجد مستند محمل
0	لا مدخلات مسماة قابلة للإزالة، أو لا صفحات محددة، أو لا مستند محمل

ملاحظات

يتعرف الفحص على مراجع Font وXObject وExtGState وColorSpace وPattern وShading وProperties، شاملة فضاءات الألوان المخصصة في قواميس الصور السطرية والاعتماديات غير المباشرة المحمولة بكائنات الموارد

إغلاق الاعتماديات يغطي فضاءات ألوان الصور والتظليل وقواعد Indexed وبدائل Separation وDeviceN والفضاءات التحتية للأنماط وبدائل ICCBased ومحتوى أنماط البلاط وكل CharProcs من النوع 3 وحالات مظهر التعليقات ومجموعات الأقنعة اللينة في ExtGState وأقنعة الصور وصور الأقنعة اللينة والصور البديلة

يشمل إغلاق الاعتماديات فضاءات ألوان الصور والتظليل وقواعد Indexed وبدائل Separation وDeviceN وفضاءات Pattern الأساسية وبدائل ICCBased ومحتوى أنماط التبليط وكل CharProcs من Type 3 وحالات مظهر التعليقات التوضيحية ومجموعات القناع الناعم في ExtGState وأقنعة الصور والصور البديلة تُطابَق أسماء PDF حساسة لحالة الأحرف وتُدمج كل طبقات محتوى كل صفحة محددة قبل التنظيف

تحفظ التدفقات المشوهة والعوامل غير المعروفة نطاق مواردها كاملًا إلا إذا ضُبط PDF_RESOURCE_PURGE_AGGRESSIVE_UNKNOWN تُنسخ قواميس الموارد المشتركة والموروثة قبل التعديل فيبقى التنظيف محليًا للصفحة أو Form أو النمط أو خط Type 3 أو المظهر أو مجموعة القناع الناعم المحددة

تنسخ قواميس الموارد المشتركة والموروثة قبل التعديل فيبقى التنظيف محليًا للصفحة أو Form أو النمط أو خط النوع 3 أو المظهر أو مجموعة القناع اللين المحددة

تعيد التدفقات المتكررة ومدخلات الاعتماديات استخدام نتائج التحليل المخزنة، بينما تنهي حدود العمق وتتبع التدفقات النشطة دورات الموارد المشوهة

1 يختار المرشح القياسي لتدفقات الملفات المضمّنة عبر /EFF؛ و0 يختار Identity

مثال

var
  Stats: TPDFlibResourcePurgeStats;
  Removed: Integer;
begin
  Removed:= PDF.PurgeUnusedResources('1-20',
    PDF_RESOURCE_PURGE_DEFAULT, Stats);
  PDF.SaveToFile('optimised.pdf');
end;

انظر أيضًا

TPDFlibResourcePurgeStats, GarbageCollectObjects, OnProgress, Abort