Deterministiska differentiella regressionsprober

HPDFCompareRegressionResultsDeterministic kör två motoradaptrar upprepade gånger över valda domäner, avvisar instabila eller misslyckade körningar och registrerar ett ordnat maskinläsbart resultat

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;

Domäner

DomänInbyggd HotPDF-signatur
rgdParserSammanfattning av sida, objekt, version, anteckning, teckensnitt, bild, formulär, signatur, kryptering, AcroForm och struktur
rgdRendererTopp-till-botten BGR-pixel SHA-256 vid fast DPI med alfa- och skannrads-utfyllnad exkluderad
rgdTextSidavgränsad UTF-8 SHA-256 efter CRLF- och CR-normalisering
rgdSaveSHA-256 och bytlängd av begränsad utdata som produceras med deterministisk ordlista-ordning

De äldre rgdSignature- och rgdConformance-värdena finns fortfarande kvar så att befintliga probadaptrar behåller sina ordinalvärden och källkompatibilitet

HPDFRegressionDomainName(Domain) returnerar det stabila gemena namnet för ett THPDFRegressionDomain-värde som parser eller renderer för loggning och rapportfält

Stabilitetskontrakt

HPDFDefaultDifferentialProbeOptions väljer tre körningar, en 256 MiB-indatagräns och stabila fallback-motornamn

RepeatCount accepterar 2 till 64 körningar; en signaturändring inom en motor markerar den domänen som instabil även när dess första signatur matchar den andra motorn

Probundantag konverteras till stabila felsignaturer som innehåller undantagsklassen och en SHA-256 av meddelandet, och alla fel gör att domänen avviker stäng-felsäkert

Samma oförändliga indata levereras i fast domän- och motorordning, och varje vald domän visas en gång i JSON-rapporten

Inbyggda gränser

Den konfigurerbara HPDFProbeHotPDFDocument-överlagringen accepterar en render-DPI, maximalt antal sidor och maximalt antal utdatabyte

Render-fingeravtryck exkluderar alfa- och radutfyllnad, textfingeravtryck normaliserar radbrytningsrepresentation och spara-utdata använder en begränsad ström före hashing

Rapport

THPDFDifferentialRegressionInfo bär jämförda och avvikande domänuppsättningar, vänster- och högersignaturer, instabila uppsättningar, feluppsättningar, motornamn, antal upprepningar och den inmatade SHA-256

HPDFDifferentialRegressionInfoToJSON avger det fasta schemat hotpdf.differential.v1 med stabil fält- och domänordning för CI, korpusuttömning och arkivlagring

Kompatibilitetshjälpare

HPDFCompareRegressionResults behåller det ursprungliga enkelskott-callbackbeteendet för anropare som redan producerar externt stabiliserade signaturer