ComparePdfSemantics porovnává vlastnosti anotací a widgetů AcroForm nezávisle na vykreslení stránky; hodnoty formulářů se mohou změnit, i když pixely appearance zůstanou stejné
Předejte TPdfDiffPagePairs z párování stránek nebo explicitní mapování; nil volí poziční páry, explicitní mapování musí pokrýt oba dokumenty právě jednou a chybějící stranu označuje -1
Identita anotace používá její název /NM, identita widgetu formuláře plně kvalifikovaný název pole; identita platí v rámci spárované stránky a druhu položky
Chybějící a opakované názvy, včetně více widgetů jednoho pole na téže stránce, se hlásí jako psckAmbiguous s explicitním důvodem; pořadí v poli anotací identitu neurčuje
Podporovaný profil porovnává řetězce, příznaky, barvy, krytí, okraje, markup, geometrii čar, vrcholů a ink, akce URI, hodnoty polí, popisky voleb a vybrané možnosti i stav checkbox či radio
CompareAppearanceStreams volitelně porovnává obsah appearance streamů anotací; standardně je vypnuté
CompareAnnotations a CompareForms vybírají příslušné druhy položek; GeometryTolerance má výchozí hodnotu 0.001 bodu uživatelského prostoru PDF
Přidané, odstraněné a změněné položky obsahují vlastnosti a hranice před změnou i po ní; BuildSemanticDiffOverlays vrací oddělené obdélníky před/po s indexy stránky a změny
Všechny indexy začínají nulou a hranice zůstávají v uživatelském prostoru PDF v bodech; před kreslením do bitmapy aplikujte odpovídající rotaci, ořez a transformaci viewportu stránky
Stránky se načítají s nezávislými nativními handles, zachovávají aktuální stránku i focus formuláře volajícího a nespouštějí akce formulářů
Profil nepokrývá pole bez widgetů, libovolné vlastní slovníky, vložené soubory, skriptové akce ani cíle jiné než URI; porovnání XFA se explicitně odmítá
Výchozí limity jsou 10,000 párů stránek, 4,096 skenovaných položek, 4,096 změn, 1 MiB na řetězec, celkem 16 MiB řetězců a 16,777,216 porovnání; vyčerpání rozpočtu odmítne neúplný výstup
Complete odlišuje úspěšné úplné porovnání od odmítnutého; změny mohou obsahovat explicitně nejednoznačné identity, proto před považováním výsledků za definitivní párování položek zkontrolujte AmbiguousCount
Skutečná akceptace Delphi/FPC Win32/Win64 pokrývá 92 assertions na cíl včetně uložených/znovu otevřených dokumentů, změn hodnot se stejnými pixely, identity Unicode, přesunu stránek, nejednoznačnosti a rozpočtů
Options := TPdfSemanticDiffOptions.Default; if not ComparePdfSemantics(BeforePdf, AfterPdf, PagePairs, Options, Report) then raise EPdfError.Create(Report.ErrorMessage); Overlays := BuildSemanticDiffOverlays(Report);
type
TPdfSemanticItemKind = (psikAnnotation, psikFormWidget);
TPdfSemanticChangeKind = (psckAdded, psckRemoved, psckChanged, psckAmbiguous);
TPdfSemanticSide = (pssBefore, pssAfter);
TPdfSemanticProperty = record
Name: string;
Value: WideString;
end;
TPdfSemanticProperties = array of TPdfSemanticProperty;
TPdfSemanticItem = record
Kind: TPdfSemanticItemKind;
Identity: WideString;
PageIndex, AnnotationIndex: Integer;
HasBounds: Boolean;
Bounds: TPdfRectangle;
Properties: TPdfSemanticProperties;
end;
TPdfSemanticPropertyChange = record
Name: string;
HasBefore, HasAfter: Boolean;
BeforeValue, AfterValue: WideString;
end;
TPdfSemanticPropertyChanges = array of TPdfSemanticPropertyChange;
TPdfSemanticChange = record
Kind: TPdfSemanticChangeKind;
ItemKind: TPdfSemanticItemKind;
Identity: WideString;
HasBefore, HasAfter: Boolean;
BeforeItem, AfterItem: TPdfSemanticItem;
Properties: TPdfSemanticPropertyChanges;
AmbiguityReason: string;
end;
TPdfSemanticChanges = array of TPdfSemanticChange;
TPdfSemanticOverlay = record
Side: TPdfSemanticSide;
PageIndex, ChangeIndex: Integer;
Kind: TPdfSemanticChangeKind;
Bounds: TPdfRectangle;
end;
TPdfSemanticOverlays = array of TPdfSemanticOverlay;
TPdfSemanticDiffOptions = record
CompareAnnotations, CompareForms, CompareAppearanceStreams: Boolean;
GeometryTolerance: Double;
MaxPagePairs, MaxItems, MaxChanges, MaxStringBytes: Integer;
MaxTotalStringBytes, MaxComparisons: Int64;
class function Default: TPdfSemanticDiffOptions; static;
end;
TPdfSemanticDiffReport = record
Complete: Boolean;
Changes: TPdfSemanticChanges;
AddedCount, RemovedCount, ChangedCount, AmbiguousCount: Integer;
ComparedItemCount: Integer;
ErrorMessage: string;
end;
// Indices are zero based. Nil PagePairs selects positional pairing. Explicit
// pairs must cover both documents exactly once; -1 denotes an absent side
// Identity is scoped to a mapped page and item kind. Missing names and repeated
// names (including repeated widgets of one field) are reported as ambiguous
// No rendering, focus changes, form actions, or positional identity guessing
// are performed. Pages are opened independently of the caller's current page
// The supported profile covers strings, flags, colors, opacity, borders,
// markup/line/vertex/ink geometry, URI actions, field values/options/checks,
// and optionally appearance streams. Arbitrary dictionaries, embedded files,
// script actions, non-URI destinations, and non-widget fields are not compared
function ComparePdfSemantics(BeforePdf, AfterPdf: TPdf;
const PagePairs: TPdfDiffPagePairs; const Options: TPdfSemanticDiffOptions;
out Report: TPdfSemanticDiffReport): Boolean;
// Bounds remain in PDF user space, in points. Transform with the destination
// page's rotation/crop/viewport rather than treating them as bitmap pixels
function BuildSemanticDiffOverlays(const Report: TPdfSemanticDiffReport):
TPdfSemanticOverlays;