CompressImages
معالجة الصور، خصائص المستند
الوصف
يضبط وضع الضغط الافتراضي المطبق على بيانات صور راستر خام تُضاف إلى المستند بعد هذا الاستدعاء. ويؤثر الإعداد في الصور التي تُرفع بكسلاتها غير مضغوطة (BMP ومصفوفات بكسلات خام)؛ أما الصور المضغوطة سلفًا (JPEG وJPEG 2000 وCCITT وJBIG2) فتحتفظ بترميزها القائم وتُخزن كما هي، لأن إعادة ضغطها ستنفخ الملف وتخفض الجودة
الصيغة
Delphi
Function TPDFlib.CompressImages(Compress: Integer): Integer;
ActiveX
Function PDFlib::CompressImages(Compress As Long) As Long
DLL
int DLCompressImages(int InstanceID, int Compress);
المعاملات
| Compress | 0 يسار، 1 أعلى، 2 يمين، أو 3 أسفل |
|---|
قيم الإرجاع
| 0 | قيمة المعامل Compress خارج النطاق |
|---|---|
| 1 | حُدث إعداد ضغط الصور |
ملاحظات
40يؤثر الإعداد فقط في الصور المضافة بعد الاستدعاء. والافتراضي هو الضغط. وإيقاف الضغط مفيد أحيانًا عند التكامل مع عارض لاحق لا يدعم تدفقات صور Flate المفككة؛ وفي الاستخدام العادي اترك الضغط مفعلاً
ضغط Flate بلا فقد. ولضغط JPEG مع فقد لصورة راستر خام، رمّز المصدر إلى JPEG قبل إضافته واستخدم AddImageFromFile أو AddImageFromStream — فيُضمَّن تدفق بايتات JPEG مباشرةً بمرشح /DCTDecode
مثال
// Compress raw bitmaps but leave the pre-encoded JPEG as-is
PDF.CompressImages(1);
PDF.AddImageFromFile('logo.bmp'); // BMP -> flate compressed
PDF.AddImageFromFile('photo.jpg'); // JPEG bytes embedded directly (DCT)
PDF.AddImageFromFile('chart.png'); // PNG decoded -> flate compressedانظر أيضا
CompressContent, CompressFonts, AddImageFromFile, AddImageFromStream