SaveAsPdfUa 메서드

SaveAsPdfUa는 먼저 일반 SaveAs를 수행한 뒤, 저장된 바이트 위에 파일을 PDF/UA-1 아카이브로 승격시키는 증분 업데이트를 얹습니다(ISO 14289-1:2014). 이 후처리는 저장된 스트림에 네 부류의 마커를 주입합니다

• PDF/UA 식별을 선언하고(pdfuaid:part = 1) 맞는 pdfaExtension:schemas 기술과 필수 dc:title 항목(ISO 14289-1 §7.1), 브리지된 Info 딕셔너리 필드(Author, Subject, Producer, Keywords, CreationDate, ModDate 등)를 담는 XMP 메타데이터 스트림
• 소스 catalog에 /MarkInfo 항목이 없을 때의 catalog /MarkInfo << /Marked true /Suspects false >> (§7.1)
• 소스에 /ViewerPreferences 항목이 없을 때의 catalog /ViewerPreferences << /DisplayDocTitle true >> (§7.1)
• 소스에 /Lang이 없고 Options.Language가 BCP 47 태그를 제공할 때의 catalog /Lang (xx) (§7.2). trailer에도 /ID 배열이 붙습니다(가능하면 FPDF_GetFileIdentifier에서 재사용하고, 아니면 소스 바이트에서 결정론적으로 유도)

출력은 원본 PDF 끝까지 기본 SaveAs 결과와 바이트 단위로 동일합니다. 뒤에 붙는 것은 증분 업데이트뿐입니다 PDF/UA를 이해하지 못하는 기존 리더도 일반 SaveAs와 똑같이 파일을 렌더링합니다. 두 오버로드의 차이는 설정을 넘기는 방식뿐입니다. 파일 이름만 받는 형태는 FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage에서 자동 채움과 함께 TPdfUaSaveOptions.Default를 쓰고, TPdfUaSaveOptions 형태는 호출자가 Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId, pdfuaid Part / Amd / Corr 식별자를 오버라이드할 수 있게 합니다

TPdfUaSaveOptions.PdfUa2는 Part 2를 선택하고 기본 pdfuaid:rev 값 2024를 제공하며, catalog에 /Version /2.0을 기록하여 증분 업데이트된 PDF 1.x source가 PDF 2.0을 유효 버전으로 갖게 합니다

성공하면 True를 반환합니다. 기본 SaveAs가 실패했거나 증분 업데이트를 붙일 수 없으면(PDF가 너무 짧음, 잘못된 trailer, 암호화된 소스) False를 반환합니다

• SaveAsPdfUa는 ISO 14289-1이 요구하는 파일 포맷 마커를 붙입니다 — 구조 트리를 생성하거나, 빠진 폰트를 임베드하거나, 그림에 Alt 텍스트를 붙이는 등 페이지 콘텐츠를 바꾸지는 않습니다. 태그된 문서(StructTreeRoot, Figure /Alt, table /TH /Scope 등)를 만드는 것은 여전히 호출자의 책임입니다. 그런 콘텐츠 수준 요건의 부재는 ValidatePdfUa로 드러내세요
• 주입은 순수하게 추가 방식입니다. 소스가 이미 /MarkInfo, /ViewerPreferences, /Lang을 갖고 있다면 그 항목들은 보존되며 SaveAsPdfUa가 덮어쓰지 않습니다. /Metadata는 언제나 새 PDF/UA XMP로 교체됩니다
• 암호화된 문서는 PDF/UA로 저장할 수 없습니다. 필요하면 먼저 SaveAs(..., saRemoveSecurity)를 호출하세요
• 후처리가 Pascal로 구현되고 메타데이터 리더를 제외하면 PDFium DLL 익스포트에 의존하지 않으므로 PDFium Delphi Component가 지원하는 모든 플랫폼에서 동작합니다