Deterministic Differential Regression Probes

HPDFCompareRegressionResultsDeterministic exécute deux adaptateurs de moteur à plusieurs reprises sur des domaines sélectionnés, rejette les exécutions instables ou en échec, et enregistre un résultat ordonné lisible par machine

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;

Domaines

Domaine	Signature HotPDF intégrée
`rgdParser`	Résumé des pages, objets, versions, annotations, polices, images, formulaires, signatures, chiffrement, AcroForm et structure
`rgdRenderer`	SHA-256 de pixels BGR de haut en bas à une DPI fixe avec alpha et remplissage de ligne exclus
`rgdText`	UTF-8 SHA-256 délimité par pages après normalisation CRLF et CR
`rgdSave`	SHA-256 et longueur en octets de la sortie bornée produite avec un ordre de dictionnaire déterministe

Les valeurs héritées rgdSignature et rgdConformance restent disponibles afin que les adaptateurs de sondage existants conservent leurs valeurs ordinales et la compatibilité source

HPDFRegressionDomainName(Domain) renvoie le nom stable en minuscules d'une valeur THPDFRegressionDomain telle que parser ou renderer, pour les champs de journalisation et de rapport

Contrat de stabilité

HPDFDefaultDifferentialProbeOptions sélectionne trois exécutions, une limite d'entrée de 256 Mio et des noms de moteur de repli stables

RepeatCount accepte de 2 à 64 exécutions ; un changement de signature au sein d'un moteur marque ce domaine comme instable même lorsque sa première signature correspond à celle de l'autre moteur

Les exceptions de sondage sont converties en signatures d'erreur stables contenant la classe d'exception et un SHA-256 du message, et toute erreur fait échouer le domaine en mode fail-closed

La même entrée immuable est fournie dans un ordre fixe de domaines et de moteurs, et chaque domaine sélectionné apparaît une fois dans le rapport JSON

Limites intégrées

La surcharge configurable HPDFProbeHotPDFDocument accepte une DPI de rendu, un nombre maximal de pages et un nombre maximal d'octets de sortie

Les empreintes de rendu excluent l'alpha et le remplissage de lignes, les empreintes de texte normalisent la représentation des sauts de ligne, et la sortie d'enregistrement utilise un flux borné avant le hachage

Rapport

THPDFDifferentialRegressionInfo transporte les ensembles de domaines comparés et différents, les signatures gauche et droite, les ensembles instables, les ensembles d'erreurs, les noms de moteurs, le nombre de répétitions et le SHA-256 de l'entrée

HPDFDifferentialRegressionInfoToJSON émet le schéma fixe hotpdf.differential.v1 avec un ordre stable des champs et des domaines pour CI, triage de corpus et stockage d'audit

Assistant de compatibilité

HPDFCompareRegressionResults conserve le comportement de rappel d'origine à exécution unique pour les appelants qui produisent déjà des signatures stabilisées en externe