Native Annotation-FDF-Austausch

Binärer FDF-Annotation-Austausch bewahrt PDF-Objektgraphen, statt jede Annotation auf ein festes XML-Vokabular abzubilden

Verwenden Sie ExportAnnotationsFDF, um FDF-Bytes zu erzeugen, und SaveAnnotationsFDFToFile, um eine unabhängige inkrementelle PDF-Revision vorzubereiten

Graphen und Appearance-Ressourcen

Der Graph bewahrt Namen, exakte numerische Tokens, literale und hexadezimale String-Bytes, Arrays, Dictionaries, indirekte Referenzen und Stream-Bytes

Annotation-Appearance-Zustände, AS-Auswahlen, gemeinsame Fonts und Bilder sowie Redact-RO-Streams behalten ihre Shared-Reference-Topologie; Ausgabeobjektnummern und Serialisierung können sich ändern

Stream-Längen werden beim Kodieren aus den bewahrten Bytes neu erzeugt; indirekte Quelllängen werden beim Dekodieren aufgelöst und vor der Veröffentlichung geprüft

Explizite lokale GoTo-Zielarrays in A, zugelassene AA-Events und Next-Ketten werden in ihrem tatsächlichen Action-Kontext auf die Seitenobjekte des Zieldokuments ummappt; ein Dictionary anderswo in einem Ressourcengraphen wird nicht allein deshalb als Action behandelt, weil seine Schlüssel einer ähneln

Der Austausch bewahrt Action-Daten, ohne Skripte auszuführen, externen Dateireferenzen zu folgen, Zielen zu navigieren oder Redactions anzuwenden

Importverhalten

FDF-Page-Werte sind nullbasierte Seitenindizes und müssen Seiten im geladenen Dokument bezeichnen

Ein übereinstimmender nichtleerer NM auf derselben Seite identifiziert eine vorhandene Annotation zum Ersetzen; eine unbenannte oder unübereinstimmende Annotation wird angehängt, und mehrdeutige Namen scheitern vor der Veröffentlichung

Semantisch unveränderte Annotation-Importe geben null zurück; exakte No-Op-Veröffentlichung und Callback-Recovery sind Teil des Abnahmevertrags

Die native Save-Methode lässt das geladene Dokument nach Erfolg wie nach Fehlschlag unverändert; laden Sie das gespeicherte PDF, um die neue Revision zu übernehmen

Berechtigungen und Grenzen

Export erfordert die Extractions-Berechtigung, während tatsächliche Annotation-Änderungen die Annotation-Berechtigung und authentifizierte Signatur-Policy-Zulassung erfordern

Zertifizierung P1 und P2 verhindern Annotation-Änderungen; erlaubte P3-Revisionen bewahren die originalen signierten Bytes, wobei verschlüsselte Eingabeberechtigungen und Field-Lock-Policies gegen das tatsächliche Dokument geprüft werden

THPDFFDFOptions begrenzt Bytes, Knoten, Objekte, Tiefe, Annotation-Anzahl und Arbeitsspeicher unabhängig voneinander, mit kooperativem Abbruch während Parsing, Vorbereitung und Ausgabe

Ein fehlgeschlagener oder abgebrochener Save bewahrt die Zieldatei und den geladenen Graphen; Callback-Clients behalten ebenfalls ihr zuletzt committetes Dokument, wenn Ausgabe oder Ergebnisveröffentlichung scheitert

Grenzen

Link, Movie, Widget, PrinterMark, Screen und TrapNet sind vom Standard-FDF-Annots-Profil ausgeschlossen

Nur-Annotation-Importe weisen nichtleere Fields und eingebettete Dokument-Differences zurück, statt ihre Effekte still zu verwerfen

Beliebige XFDF-Appearance-Container-Syntax, Annotation-Löschung, Verarbeitung eingebetteter FDF-Dateien und das Anwenden eingebetteter Dokumentrevisionen bleiben eigene Arbeiten

Appearance-Transport bewahrt mitgelieferte AP-Ressourcen; er synthetisiert keine fehlende Appearance und führt die Action einer Annotation nicht aus

Siehe nativen Annotation-XFDF-Austausch für das XML-Profil und THPDFFDFAnnotationGraph für die eigenständige Graph-API

Explizite Annotation-Entfernung

Seiten-und-Namen-Annotation-Entfernung ist eine separate Operation; das Weglassen einer Annotation aus importiertem FDF oder XFDF löscht sie nicht

Widget-Feldbaum-Löschung und sicheres Löschen erfordern separate Operationen; inkrementelle Entfernung bewahrt frühere PDF-Bytes