مرجع HotPDF

تُشغِّل HPDFCompareRegressionResultsDeterministic مُكيِّفَي محرك بشكل متكرّر عبر النطاقات المختارة، وترفض عمليات التشغيل غير المستقرة أو الفاشلة، وتسجّل نتيجة واحدة مرتَّبة قابلة للقراءة آليًا

API

function HPDFCompareRegressionResultsDeterministic(
  const Input: TBytes;
  Domains: THPDFRegressionDomains;
  const LeftProbe, RightProbe: THPDFRegressionProbe;
  const Options: THPDFDifferentialProbeOptions;
  out AInfo: THPDFDifferentialRegressionInfo): Boolean;

function HPDFProbeHotPDFDocument(
  Domain: THPDFRegressionDomain;
  const Input: TBytes): AnsiString;

function HPDFDifferentialRegressionInfoToJSON(
  const AInfo: THPDFDifferentialRegressionInfo): AnsiString;

النطاقات (Domains)

النطاق	توقيع HotPDF المدمج
`rgdParser`	ملخص الصفحات والكائنات والإصدارات والتعليقات التوضيحية والخطوط والصور والنماذج والتواقيع والتشفير وAcroForm والبنية
`rgdRenderer`	SHA-256 لبكسلات BGR من الأعلى إلى الأسفل عند DPI ثابت مع استبعاد قناة alpha وحشو أسطر المسح
`rgdText`	SHA-256 لنص UTF-8 محدَّد بالصفحات بعد تطبيع CRLF و CR
`rgdSave`	SHA-256 وطول البايتات للمخرج المحدود المُنتَج بترتيب قاموس حتمي

تبقى القيمتان القديمتان rgdSignature وrgdConformance متاحتَين حتى تحافظ مُكيِّفات الاستطلاع (probe) الموجودة على قيمها الترتيبية وتوافقها المصدري

تُعيد HPDFRegressionDomainName(Domain) الاسم الثابت بأحرف صغيرة لإحدى قيم THPDFRegressionDomain مثل parser أو renderer لأغراض التسجيل وحقول التقارير

عقد الاستقرار

تختار HPDFDefaultDifferentialProbeOptions ثلاث عمليات تشغيل، وحد مُدخل 256 ميبيبايت، وأسماء محركات احتياطية ثابتة

تقبل RepeatCount من 2 إلى 64 عملية تشغيل؛ ويضع أي تغيّر في التوقيع داخل محرك واحد علامة على أن النطاق غير مستقر حتى لو طابق توقيعه الأول المحرك الآخر

تُحوَّل استثناءات الاستطلاع (probe) إلى توقيعات خطأ ثابتة تحتوي على فئة الاستثناء وSHA-256 للرسالة، ويسبب أي خطأ اختلاف النطاق فشلًا آمنًا (fail-closed)

يُقدَّم المُدخل غير القابل للتغيير نفسه بترتيب ثابت للنطاقات والمحرّكات، ويظهر كل نطاق محدد مرة واحدة في تقرير JSON

الحدود المدمجة

يقبل الحمل الزائد (overload) القابل للتهيئة لـ HPDFProbeHotPDFDocument دقة رسم DPI، وأقصى عدد صفحات، وأقصى بايتات مخرجات

تستبعد بصمات الرسم قناة alpha وحشو الصفوف، وتطبّع بصمات النص تمثيل أسطر جديدة، ويستخدم مخرج الحفظ تدفقًا محدودًا قبل التجزئة

التقرير

تحمل THPDFDifferentialRegressionInfo مجموعات النطاقات المقارنة والمختلفة، والتوقيعَين الأيسر والأيمن، والمجموعات غير المستقرة، ومجموعات الأخطاء، وأسماء المحركات، وعدد التكرار، وSHA-256 الخاص بالمُدخل

تُصدر HPDFDifferentialRegressionInfoToJSON المخطط الثابت hotpdf.differential.v1 بترتيب حقول ونطاقات ثابت لأجل CI وفرز المجموعة (corpus) وتخزين التدقيق

تابع التوافق

تحافظ HPDFCompareRegressionResults على سلوك الاستدعاء الأصلي أحادي التشغيل للمستدعين الذين ينتجون بالفعل توقيعات مُستقرَّة خارجيًا