AddImageJBIG2FromFileEx

الصور

الوصف

يحمل ملف نقطي، ويحوله إلى بيانات صورة أحادية اللون، ويخزنه كصورة JBIG2 XObject باستخدام معلمات خيارات مسماة

الصيغة

Delphi

Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;

المعاملات

FileNameملف النقطيات المراد ترميزه
Interpolateيكتب علامة استيفاء الصورة عندما تكون غير صفرية
SymbolExtractيطلب استخراج قاموس الرموز عندما تدعم ذلك الواجهة الخلفية النشطة للمشفر
UseExternalEncoderيفضل الواجهة الخلفية لمشفر JBIG2 الخارجي عندما تكون متاحة
SkipBlackDotsتمكن من تنظيف النقاط السوداء المعزولة قبل الترميز عندما لا تكون القيمة صفرًا
BlackDotSizeالحد الأقصى لحجم عنقود البكسلات السوداء المعزولة الذي تمت إزالته أثناء التنظيف
LossyLevelتلميح شدة التنظيف من 0 إلى 9 لمدخلات اللون الواحد الممسوحة ضوئيًا

قيم الإرجاع

يرجع ImageID الجديد، أو 0 عندما يتعذر قراءة الملف أو ترميزه

ملاحظات

تقوم الدالة بتعيين المعلمات المسماة إلى نفس مسار الترميز المستخدم بواسطة AddImageJBIG2FromFile، مما يحافظ على التوافق مع أقنعة البت الخيار الحالية

تسجيل backends الخاصين بـ JBIG2

المشفِّر خلف عائلة AddImageJBIG2* والمفكك المستخدم لصور JBIG2 في المستندات المستوردة قابلان للاستبدال (pluggable). وتكشف وحدة PDFlibJBIG2Enc سطح التسجيل بوصفه دوالًا مستقلة:

RegisterJBIG2EncoderBackendيثبّت TJBIG2EncodeCallback يستقبل خطوط المسح والعرض والارتفاع وسجل TJBIG2EncodeOptions ويعيد بيانات الصورة المضغوطة وبيانات مقطع عام اختيارية؛ ويخدم طلب UseExternalEncoder المقدم عبر الخيار أدناه
RegisterJBIG2DecoderBackendيثبّت TJBIG2DecodeCallback الأساسي، الذي يستقبل بايتات الصورة والبيانات العامة ويملأ سجل TJBIG2DecodeResult
RegisterJBIG2ExternalDecoderBackendيسجّل خلفية فك التشفير الخارجية (مفكك jbig2dec بلغة C على Win64). عندما يكون مسجلًا ومفتاح تفضيل الخارجي قيد التشغيل (الافتراضي)، يمر مسار تحميل /JBIG2Decode عبره ويبقى المفكك الأساسي احتياطيًا
ClearJBIG2Backendsيزيل كل callbacks المشفِّر والمفكك المسجلة
IsJBIG2EncoderBackendAvailable / IsJBIG2DecoderBackendAvailable / IsJBIG2ExternalDecoderBackendAvailableتُبلغ عن ما إذا كان callback المقابل مسجلًا حاليًا
SetPreferExternalJBIG2Decoder / GetPreferExternalJBIG2Decoderمفتاح عام يختار المفكك الخارجي بدل مفكك Pascal المدمج عندما يكون كلاهما متاحًا؛ الافتراضي True، واضبط False لإجبار الاحتياطي الأصلي
DefaultJBIG2EncodeOptionsيعيد سجل TJBIG2EncodeOptions مهيأً بالقيم الافتراضية التي تبدأ منها استدعاءات AddImageJBIG2* (بلا فقد، symbol dictionary مفعّل، المقاطع العامة معطلة، مشفِّر خارجي مفضَّل)
ClearJBIG2DecodeResultيحرر ذاكرة خطوط المسح المملوكة لسجل TJBIG2DecodeResult ويعيد ضبط حقوله