DownsampleImages
إدارة المستندات، الصور
الوصف
يخفّض دقة كائنات XObjects للصور المضمّنة التي تتجاوز دقتها الفعلية قيمة MaxDPI. تُفكّ ترميز كل صورة مرشَّحة، ويُعاد أخذ عيناتها مع الحفاظ على نسبة أبعادها، ثم يُعاد ترميزها بصيغة DCTDecode (JPEG) حين تكون Quality أكبر من 0 أو بصيغة FlateDecode (PNG) بلا فقد حين تكون Quality تساوي 0؛ وتُعاد كتابة مدخلات تدفق الصورة و/Filter و/Width و/Height في مواضعها
الصيغة
Delphi
Function TPDFlib.DownsampleImages(MaxDPI, Quality, Filter: Integer): Integer;المعاملات
| MaxDPI | عتبة الدقة بوحدة DPI؛ تُعاد أخذ عينات الصور التي تتجاوز دقتها الفعلية المقدَّرة هذه القيمة. القيم الأدنى من 24 تُجهض الاستدعاء |
|---|---|
| Quality | جودة ضغط JPEG بين 1 و100 تُستخدم لإعادة الترميز؛ مرّر 0 لإعادة ترميز بلا فقد بصيغة PNG |
| Filter | القيمة 0 تختار مرشّح الصندوق الذي يوسط كتل بكسلات المصدر؛ وأي قيمة أخرى تختار إعادة أخذ العينات الثنائية الخطية |
القيم المُعادة
عدد كائنات XObjects للصور التي أُعيدت كتابتها، أو 0 حين تكون MaxDPI أدنى من 24 أو لا تتجاوز أي صورة العتبة
ملاحظات
تُقدَّر الدقة الفعلية من عرض البكسل المصرَّح به للصورة في مواجهة صفحة بعرض Letter، لذا فهذه التمريرة متحفظة وتُترك صور جودة الطباعة وشأنها عند الشك
الصور الأصغر من 8 × 8 بكسلًا مصرَّحًا به، والصور التي يفشل فك ترميزها، والصور التي لم يكن حجمها بعد إعادة العينات أصغر من الأصل، تُتخطى دون إفشال الاستدعاء
مثال
PDF.LoadFromFile('scan.pdf', '');
PDF.DownsampleImages(150, 80, 0);
PDF.SaveToFile('scan-compressed.pdf');