네이티브 주석 FDF 교환

바이너리 FDF 주석 교환은 각 주석을 고정 XML 어휘로 매핑하는 대신 PDF 객체 그래프를 보존합니다

ExportAnnotationsFDF로 FDF 바이트를 만들고, SaveAnnotationsFDFToFile로 독립적인 증분 PDF 리비전을 준비합니다

그래프와 appearance 리소스

그래프는 이름, 정확한 숫자 토큰, 리터럴 및 16진수 문자열 바이트, 배열, 사전, 간접 참조, 스트림 바이트를 유지합니다

주석 appearance 상태, AS 선택, 공유 폰트와 이미지, Redact RO 스트림은 공유 참조 토폴로지를 유지합니다. 출력 객체 번호와 직렬화는 바뀔 수 있습니다

스트림 길이는 인코딩 시 유지된 바이트에서 다시 만들어지고, 간접 소스 길이는 디코딩 중 해석되어 게시 전에 검사됩니다

A의 명시적 로컬 GoTo 목적지 배열, 인정되는 AA 이벤트, Next 체인은 실제 action 컨텍스트에서 대상 문서의 페이지 객체로 재매핑됩니다. 리소스 그래프의 다른 사전은 키가 action과 비슷하다는 이유만으로 action으로 취급되지 않습니다

교환은 스크립트 실행, 외부 파일 참조 따르기, 목적지 탐색, redaction 적용 없이 action 데이터를 보존합니다

가져오기 동작

FDF Page 값은 0-기반 페이지 인덱스이며 로드된 문서의 페이지를 식별해야 합니다

같은 페이지의 일치하는 비어 있지 않은 NM은 교체할 기존 주석을 식별합니다. 이름 없거나 일치하지 않는 주석은 추가되고, 모호한 이름은 게시 전에 실패합니다

의미적으로 변하지 않은 주석 가져오기는 0을 반환합니다. 정확한 no-op 게시와 콜백 복구는 acceptance 계약의 일부입니다

네이티브 저장 메서드는 성공과 실패 모두에서 로드된 문서를 그대로 둡니다. 새 리비전을 적용하려면 저장된 PDF를 로드하세요

권한과 한계

내보내기에는 추출 권한이 필요하고, 실제 주석 변경에는 주석 권한과 인증된 시그니처 정책 인정이 필요합니다

인증 P1과 P2는 주석 변경을 막습니다. 허용되는 P3 리비전은 원본 서명 바이트를 유지하며, 암호화 입력 권한과 필드 잠금 정책은 실제 문서를 기준으로 평가됩니다

THPDFFDFOptions는 바이트, 노드, 객체, 깊이, 주석 수, 작업 저장소를 독립적으로 유계하고, 파싱, 준비, 출력 전반에 협력적 취소가 적용됩니다

실패하거나 취소된 저장은 목적지 파일과 로드된 그래프를 보존합니다. 콜백 클라이언트는 출력이나 결과 게시가 실패해도 마지막으로 커밋된 문서를 유지합니다

경계

Link, Movie, Widget, PrinterMark, Screen, TrapNet은 표준 FDF Annots 프로파일에서 제외됩니다

주석 전용 가져오기는 비어 있지 않은 Fields와 내장 문서 Differences를 조용히 버리는 대신 거부합니다

임의 XFDF appearance 컨테이너 문법, 주석 삭제, 내장 FDF 파일 처리, 내장 문서 리비전 적용은 별개의 작업입니다

appearance 전송은 공급된 AP 리소스를 보존하며, 누락된 appearance를 합성하거나 주석의 action을 실행하지 않습니다

XML 프로파일은 매핑 XFDF 교환을, 독립 그래프 API는 THPDFFDFAnnotationGraph를 참고하세요

명시적 주석 제거

페이지와 이름 기반 주석 제거는 별개의 연산입니다. 가져온 FDF나 XFDF에서 주석을 생략해도 삭제되지 않습니다

Widget 필드 트리 삭제와 보안 삭제에는 별개의 연산이 필요합니다. 증분 제거는 이전 PDF 바이트를 유지합니다