Sondas diferenciales de regresión deterministas
HPDFCompareRegressionResultsDeterministic ejecuta dos adaptadores de motor repetidamente en los dominios seleccionados, rechaza las ejecuciones inestables o fallidas y registra un resultado ordenado legible por máquina
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;
Dominios
| Dominio | Firma HotPDF integrada |
|---|---|
rgdParser | Resumen de página, objeto, versión, anotación, fuente, imagen, formulario, firma, cifrado, AcroForm y estructura |
rgdRenderer | SHA-256 de píxeles BGR de arriba a abajo a un DPI fijo con alfa y relleno de línea de escaneo excluidos |
rgdText | SHA-256 UTF-8 delimitado por página después de la normalización de CRLF y CR |
rgdSave | SHA-256 y longitud de bytes de la salida acotada producida con orden de diccionario determinista |
Los valores heredados rgdSignature y rgdConformance siguen disponibles para que los adaptadores de sonda existentes conserven sus valores ordinales y la compatibilidad de origen
HPDFRegressionDomainName(Domain) devuelve el nombre estable en minúsculas de un valor THPDFRegressionDomain, como parser o renderer, para campos de logging e informes
Contrato de estabilidad
HPDFDefaultDifferentialProbeOptions selecciona tres ejecuciones, un límite de entrada de 256 MiB y nombres de motor de respaldo estables
RepeatCount acepta de 2 a 64 ejecuciones; un cambio de firma dentro de un motor marca ese dominio como inestable incluso cuando su primera firma coincide con el otro motor
Las excepciones de sonda se convierten en firmas de error estables que contienen la clase de excepción y un SHA-256 del mensaje, y cualquier error hace que el dominio en desacuerdo falle de forma cerrada
La misma entrada inmutable se suministra en un orden fijo de dominio y motor, y cada dominio seleccionado aparece una vez en el informe JSON
Límites integrados
La sobrecarga configurable de HPDFProbeHotPDFDocument acepta un DPI de renderizado, un recuento máximo de páginas y un máximo de bytes de salida
Las huellas de renderizado excluyen alfa y relleno de fila, las huellas de texto normalizan la representación de nuevas líneas y la salida de guardado usa un flujo acotado antes de calcular el hash
Informe
THPDFDifferentialRegressionInfo lleva los conjuntos de dominios comparados y diferentes, las firmas izquierda y derecha, los conjuntos inestables, los conjuntos de error, los nombres de motor, el recuento de repeticiones y el SHA-256 de entrada
HPDFDifferentialRegressionInfoToJSON emite el esquema fijo hotpdf.differential.v1 con orden estable de campo y dominio para CI, clasificación de corpus y almacenamiento de auditoría
Ayudante de compatibilidad
HPDFCompareRegressionResults conserva el comportamiento original de devolución de llamada de una sola ejecución para los llamadores que ya producen firmas estabilizadas externamente