Standard XFDF stamp appearance-transport

Stamp-annotationer kan eksportere og importere deres faktiske PDF appearance-streams og ressourcedictionaries gennem Adobe XFDF appearance-elementet

stamp-typed-xml-v1-profilen bruger base64-encodet UTF-8 typet XML som beskrevet af Adobe XFDF 3-specifikationen; den dekodede payload repræsenterer PDF-objekter snarere end en komplet PDF- eller FDF-fil

Mappede ressourcer

Topniveau DICT KEY="AP" indeholder en krævet normal N Form-stream samt valgfrie rollover R og down D-streams

Forms beholder deres finitære fire-tals BBox, valgfri seks-tals Matrix og understøttet ressourcegraf, inklusive fonts og deres indlejrede programmer, billeder og soft masks, farverum, mønstre, shadings, funktioner og graphics states

Typede værdier inkluderer DICT, STREAM, ARRAY, INT, FIXED, NAME, BOOL og NULL; dictionary-nøgler og navneværdier bevarer deres semantiske PDF-navne, og gyldige kildetals-tokens bevarer decimalpræcision

Stream DATA understøtter MODE="RAW" eller MODE="FILTERED" med ENCODING="HEX" eller seven-bit ENCODING="ASCII"; RAW beholder de encodede bytes og deres Filter/DecodeParms, mens FILTERED installerer dekodede bytes uden forældet filtermetadata

Eksport bruger RAW hexadecimale data og regenererer stream Length ud fra faktiske bytes; autentificerede krypterede streams dekodes eller dekrypteres inden udveksling og krypteres korrekt i den gemte revision

Delte acykliske ressourcer udvides som ækvivalente værdier og importeres med uafhængige objektreferencer; denne profil bevarer ikke reference-identitet

Indlejrede fontprogram-bytes og deres embedding-flag bevares uden at ændre licensbits eller substituere et andet fontprogram

API'er og callbacks

Brug HPDFExportHeadlessAnnotationsXFDF og SaveAnnotationsXFDFToFile til native transaktioner eller de afgrænsede overloads af HPDFXFDFExportAnnotations og HPDFXFDFImportAnnotations til kalder-ejede grafadapters

De eksisterende Windows file jobs og V1-callbacks og Linux V1-callbacks bruger deres eksisterende annotationsoperationer og record-layouts

Capabilities beholder appearanceImport=false for generelle annotation-appearances og tilføjer stampAppearanceImport=true, appearanceProfile="stamp-typed-xml-v1", appearanceTypes=["stamp"], appearanceDataModes=["RAW","FILTERED"], appearanceEncodings=["ASCII","HEX"] og appearanceResources="acyclic-expanded-graph"

Transaktioner og grænser

Input-XML, base64, navne, stream-encoding, resourcetyper, semantiske dictionary-nøgler og Form-geometri valideres inden publicering; misdannet data, cyklusser, opbrugte kumulative grænser eller cancellation fikser hele transaktionen

XFDF-grænser dækker samlet input/output, XML- og grafnoder, dybde, stream-lager og arbejdsreservationer på tværs af annotationsoperationen

Import beholder aktuel ugernet graftilstand, AES R5/R6-sikkerhed og autentificerede certificeringsbegrænsninger; P1/P2 nægter annotationsændringer, og P3 bevarer det originale signerede præfiks og rigtig signaturintegritet

En autoriseret tom import returnerer nul og bevarer eksakte aktuelle PDF-bytes, når der ikke er ugernede ændringer; dirty grafændringer gemmes uden at blive kasseret

Windows- og Linux callback-kontekster adopterer en forberedt PDF først, efter at PDF-output, JSON-resultat-output og det sidste cancellation-tjek lykkes; mislykkede eller delvise callbacks beholder den tidligere kontekst, og den første mislykkede writer forbliver sticky

Annotation-kun-import accepterer tomme fields-containere og værdiløse feltdeklarationer som no-op-metadata; rigtige formulerværdier og rich feltopdateringer kræver den separate autentificerede form-data-operation

Tilbageværende arbejde

Generel annotation AP-transport, appearance-tilstandsdictionaries, streng-ressourceværdier, ikke-tomme DEFINE/REF-referencer, cykliske grafer, Redact overlayappearance, annotationserstatning/-fjernelse og FDF-annotationsudveksling forbliver separat arbejde

Geometriske og tekst-annotationer uden transporteret stamp-appearance beholder deres eksisterende adfærd; operationen syntetiserer ikke vilkårlige annotation-appearances eller afvikler handlinger

Den delte afgrænsede adapter reserverer rå annotationsnøgler og udvidede AP-grafer inden payload-konvertering og reserverer base64-whitespace og dekodet DATA inden de repræsentationer allokeres; PDF navnekonvertering bruger lineære gennemløb med cancellation-checkpoints