Begrenzte PDF-Vergleichs-Helper

FPdfDiff implementiert Seitenausrichtung, UTF-16-Textänderungen und zusammenhängende visuelle Regionen für CompareWith

AlignPdfDiffPages paart identische Texte, Geometrien und visuelle Fingerprints mit einer begrenzten längsten gemeinsamen Teilfolge ; verbleibende exakte Treffer werden als Verschiebungen erkannt, ungepaarte Lücken als Änderungen

Doppelte Seiten werden deterministisch gepaart ; eine gleichzeitig verschobene und geänderte Seite wird nicht zwingend als Verschiebung erkannt

BuildPdfDiffTextChanges liefert nullbasierte UTF-16-Offsets und Längen ; der Zeichenmodus hält Surrogatpaare zusammen, der Wortmodus gruppiert Leerraum getrennt von anderen Zeichen

BuildPdfDiffPixelRegions fasst zusammenhängende geänderte Kacheln zu Pixelrechtecken mit exklusiver rechter und unterer Grenze zusammen ; diese können unveränderte Pixel innerhalb einer Kachel enthalten

Die Ausrichtung erlaubt höchstens 4,096 Seiten pro Seite und 16,777,216 Zellen ; Text höchstens 65,536 Tokens und 16,777,216 UTF-16-Einheiten, mit expliziter Kürzung bei erschöpften Detailbudgets

Öffentliche Deklarationen

type
  TPdfDiffPageKind= (dpkMatched, dpkModified, dpkMoved, dpkInserted, dpkDeleted);
  TPdfDiffTextMode= (dtmNone, dtmCharacters, dtmWords);
  TPdfDiffPageSignature= record
    Text: WideString;
    VisualHash: UInt64;
    Width, Height: Single;
    Rotation: Integer;
  end;
  TPdfDiffPageSignatures= array of TPdfDiffPageSignature;
  TPdfDiffPagePair= record
    LeftPageIndex, RightPageIndex: Integer;
    Kind: TPdfDiffPageKind;
  end;
  TPdfDiffPagePairs= array of TPdfDiffPagePair;
  // Offsets and lengths count UTF-16 code units, starting at zero
  TPdfDiffTextChange= record
    LeftStart, LeftLength, RightStart, RightLength: Integer;
  end;
  TPdfDiffTextChanges= array of TPdfDiffTextChange;
  TPdfDiffPixelRegion= record
    Left, Top, Right, Bottom: Integer;
  end;
  TPdfDiffPixelRegions= array of TPdfDiffPixelRegion;

function AlignPdfDiffPages(const Left, Right: TPdfDiffPageSignatures;
  MaxCells: Integer): TPdfDiffPagePairs;
function BuildPdfDiffTextChanges(const Left, Right: WideString;
  Mode: TPdfDiffTextMode; MaxCells, MaxTokens: Integer;
  out Truncated: Boolean): TPdfDiffTextChanges;
function BuildPdfDiffPixelRegions(const Mask: TBytes; Width, Height,
  TileSize, MaxRegions: Integer; out Truncated: Boolean): TPdfDiffPixelRegions;