Standard XFDF stamp appearance transport

Adnotacje stempli mogą eksportować i importować swoje rzeczywiste strumienie wyglądów PDF i słowniki zasobów przez element appearance Adobe XFDF

Profil stamp-typed-xml-v1 używa base64 zakodowanego typowanego XML UTF-8, jak opisano w specyfikacji Adobe XFDF 3; zdekodowany ładunek reprezentuje obiekty PDF, a nie kompletny plik PDF albo FDF

Mapped resources

Najwyższego poziomu DICT KEY="AP" zawiera wymagany strumień Form normal N i opcjonalne strumienie rollover R i down D

Formy zachowują skończone czteroliczbowe BBox, opcjonalną sześcioliczbową Matrix i obsługiwany graf zasobów, łącznie z fontami i ich osadzonymi programami, obrazami i miękkimi maskami, przestrzeniami kolorów, wzorcami, shadingami, funkcjami i stanami grafiki

Typowane wartości to DICT, STREAM, ARRAY, INT, FIXED, NAME, BOOL i NULL; klucze słowników i wartości name zachowują swoje semantyczne nazwy PDF, a poprawne tokeny liczb źródła zachowują precyzję dziesiętną

Strumieniowy DATA wspiera MODE="RAW" albo MODE="FILTERED" z ENCODING="HEX" albo siedmiobitowym ENCODING="ASCII"; RAW zachowuje zakodowane bajty i ich Filter/DecodeParms, podczas gdy FILTERED instaluje zdekodowane bajty bez przestarzałych metadanych filtrowania

Eksport używa danych RAW szesnastkowych i regeneruje Length strumienia z rzeczywistych bajtów; uwierzytelnione zaszyfrowane strumienie są dekodowane albo deszyfrowane przed wymianą i poprawnie szyfrowane w zapisanej rewizji

Współdzielone acykliczne zasoby są rozwijane jako równoważne wartości i importowane z niezależnymi referencjami obiektów; ten profil nie zachowuje tożsamości referencji

Bajty osadzonych programów fontów i ich flagi osadzania są zachowywane bez zmieniania bitów licencji i podstawiania innego programu fontu

APIs and callbacks

Użyj HPDFExportHeadlessAnnotationsXFDF i SaveAnnotationsXFDFToFile dla transakcji natywnych, albo ograniczonych przeciążeń HPDFXFDFExportAnnotations i HPDFXFDFImportAnnotations dla adapterów grafu wywołującego

Istniejące zadania plikowe Windows i callbacki V1 oraz callbacki V1 Linux używają swoich istniejących operacji adnotacji i layoutów rekordów

Zdolności zachowują appearanceImport=false dla ogólnych wyglądów adnotacji i dodają stampAppearanceImport=true, appearanceProfile="stamp-typed-xml-v1", appearanceTypes=["stamp"], appearanceDataModes=["RAW","FILTERED"], appearanceEncodings=["ASCII","HEX"] i appearanceResources="acyclic-expanded-graph"

Transactions and limits

Wejściowy XML, base64, nazwy, kodowanie strumieni, typy zasobów, semantyczne klucze słowników i geometria Form są walidowane przed publikacją; wadliwe dane, cykle, wyczerpane limity narastające albo anulowanie zawodzi kompletną transakcję

Limity XFDF pokrywają łączne wejście/wyjście, węzły XML i grafu, głębokość, storage strumieni i rezerwacje robocze w operacji adnotacji

Import zachowuje bieżący niezapisany stan grafu, bezpieczeństwo AES R5/R6 i uwierzytelnione ograniczenia certyfikacji; P1/P2 zabraniają zmian adnotacji, a P3 zachowuje oryginalny podpisany prefiks i prawdziwą integralność podpisu

Autoryzowany pusty import zwraca zero i zachowuje dokładne bieżące bajty PDF, gdy nie ma niezapisanych zmian; brudne zmiany grafu są zapisywane bez odrzucania

Konteksty callbacków Windows i Linux adoptują przygotowany PDF dopiero po sukcesie wyjścia PDF, wyjścia wyniku JSON i finalnego checku anulowania; nieudane albo częściowe callbacki zachowują poprzedni kontekst, a pierwszy nieudany writer pozostaje lepki

Import wyłącznie adnotacji akceptuje puste kontenery fields i deklaracje pól bez wartości jako metadane no-op; rzeczywiste wartości formularzy i aktualizacje pól rich wymagają odrębnej uwierzytelnionej operacji form-data

Remaining work

Ogólny transport AP adnotacji, słowniki stanów wyglądów, wartości zasobów napisowych, niepuste referencje DEFINE/REF, grafy cykliczne, Redact overlayappearance, zastępowanie/usuwanie adnotacji i wymiana adnotacji FDF pozostają odrębną pracą

Geometryczne i tekstowe adnotacje bez transportowanego wyglądu stempla zachowują istniejące zachowanie; ta operacja nie syntetyzuje dowolnych wyglądów adnotacji i nie wykonuje akcji

Współdzielony ograniczony adapter rezerwuje surowe klucze adnotacji i rozwinięte grafy AP przed konwersją ładunku, i rezerwuje białe znaki base64 oraz zdekodowane DATA przed alokacją tych reprezentacji; konwersja nazw PDF używa przebiegów liniowych z checkpointami anulowania