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);

المعاملات

Compress0 يسار، 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