Native annotation XFDF exchange
HPDFHeadlessXFDF exporterar mappade annoteringar ur en inläst nativ PDF-graf och förbereder XFDF-annoteringsimporter som en oberoende inkrementell revision
Använd HPDFExportHeadlessAnnotationsXFDF för UTF-8 XML-byte och SaveAnnotationsXFDFToFile för att lägga till annoteringar i ett befintligt dokument utan att ändra den inlästa källgrafen
Mappad annoteringsprofil
Profilen mappar Text, FreeText, Line, Square, Circle, Polygon, PolyLine, Highlight, Underline, StrikeOut, Squiggly, Stamp, Ink, Caret, FileAttachment, Sound, Redact och Link
Gemensamma värden inkluderar page, rektangel, Unicode-innehåll, författare, annoteringsnamn, datum, subject, flaggor, opacitet, färger och stödda kantegenskaper
Typspecifika värden inkluderar fyrhörningskoordinater, vertices, bläckgester, linjeändar och baslinjegeometri, FreeText intent/callout/fringe/standard-textegenskaper, Redact upprepatillstånd, URI- eller Named-länkåtgärder, externa GoToR-åtgärderoch namngivna eller explicita lokala destinationer och GoTo-åtgärder
Tomma färgkomponentarrayer bevarar transparenta färger; Gray- och CMYK-källfärger mappas till XFDF RGB-värden, och RGB-komponenter kvantiseras till formatets sexsiffriga hexadecimala representation
FileAttachment-exporter föredrar Unicode-filnamnet och bevarar extern filmetadata även när ingen inbäddad ström finns; inbäddad fil- och ljuddata avkodas till avgränsad kanonisk base64 och importeras som faktiska indirekta strömmar, inklusive tomma strömmar
Popup-annoteringar representeras som kapslade popup-element och importeras med indirekta Parent-, Popup- och sidlänkar; svar löses i ett andra pass mot befintliga och nytillagda annoteringsnamn, inklusive framåtreferenser
Rich-innehåll bevarar XHTML-namnområdet, ordnat blandat textinnehåll och ärvda namnområdesbindningar
Transaktioner och behörigheter
Import lägger till annoteringar och avvisar dubblettnamn, tvetydiga eller saknade svarsmål och ogiltiga mappade värden före publicering
En misslyckad eller avbruten import bevarar destinationsfilen och den inlästa källgrafen; en lyckad import lämnar också den inlästa källan oförändrad, så läs den sparade filen när du vill adoptera dess nya revision
Export kräver extraktionsbehörighet och import kräver annoteringsbehörighet; AES-256 R5/R6-säkerhet förblir i den sparade revisionen
Faktisk certifieringspolicy autentiseras genom det nativa signaturarbetsflödet: P1 och P2 förhindrar annoteringsändringar, medan P3 tillåter en annoteringsrevision som bevarar de ursprungliga signerade bytena
Gränser
THPDFHeadlessXFDFOptions begränsar indata-/utdatabyte, annoteringsantal, graf- och XML-noder, djup och arbetslagring, med samarbetsvilligt avbrott
Mappade tal måste vara ändliga och inom absolut värde en miljon, med ytterligare begränsningar för koordinatantal, opacitet, sampelstorlekar och andra typade värden
Heldokument-XML-tillåtelse kontrollerar kodning, namnområden, dubblettattribut, entiteter och completa struktur före annoteringsmappning; DTD och extern entitetsbearbetning är avstängda
Operationsgränser
Profilen transporterar inte godtyckliga AP-utseendeströmmar, anpassade annoteringsordlistor, annoteringsersättning/borttagning, godtyckliga åtgärder eller FDF-annoteringsdata
Annoteringsutseendesynstes och rendering är separata operationer; att importera geometriska och textegenskaper skapar ingen AP-ström
Andra källannoteringssubtyper hoppas över under export och räknas i resultatet; felformade valda mappade värden låter operationen misslyckas utan partiell returnerad XML
Det nativa Pascal-API:et fungerar på Windows och Linux; den versionshanterade Linux C-ABI:n exponerar också återanropsbaserade JSON-annoteringsoperationer, och Windows-filjobb och V1-återanrop exponerar samma mappade annoteringsutbyte
Det nativa Pascal-API:et fungerar på Windows och Linux; den versionerade Linux C-ABI:n exponerar även callback-baserade JSON-annoteringsoperationer, och Windows-filjobb och V1-callbacks exponerar samma mappade annoteringsutbyte