SaveAsPdfUa metoda

SaveAsPdfUa najprej izvede običajni SaveAs, nato nad shranjenimi bajti nanese postopno posodobitev, ki datoteko povzdigne v arhiv PDF/UA-1 (ISO 14289-1:2014). Naknadna obdelava v shranjeni tok vstavi štiri razrede oznak:

• Tok metapodatkov XMP, ki razglaša identifikacijo PDF/UA (pdfuaid:part = 1) plus pripadajoči opis pdfaExtension:schemas, obvezni vnos dc:title (ISO 14289-1 §7.1) in premostena polja slovarja Info (Author, Subject, Producer, Keywords, CreationDate, ModDate itd.).
• Kataloški /MarkInfo << /Marked true /Suspects false >>, kadar izvorni katalog nima vnosa /MarkInfo (§7.1).
• Kataloški /ViewerPreferences << /DisplayDocTitle true >>, kadar izvor nima vnosa /ViewerPreferences (§7.1).
• Kataloški /Lang (xx), kadar izvor nima /Lang in Options.Language posreduje oznako BCP 47 (§7.2). Priponka dobi tudi polje /ID (po potrebi ponovno uporabljeno iz FPDF_GetFileIdentifier, sicer deterministično izvedeno iz izvornih bajtov).

Izhod je do konca izvirnega PDF bytno enak rezultatu osnovnega SaveAs; pripne se le postopna posodobitev. Bralniki, ki ne razumejo PDF/UA, datoteko še vedno izrišejo natanko tako, kot bi običajni SaveAs. Dve preobilitvi se razlikujeta le v načinu posredovanja nastavitev: oblika samo z imenom datoteke uporabi TPdfUaSaveOptions.Default s samodejnim izpolnjevanjem iz FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage, oblika TPdfUaSaveOptions pa klicatelju omogoča prepis Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId ter identifikatorje pdfuaid Part, Revision, Amd in Corr.

TPdfUaSaveOptions.PdfUa2 izbere Part 2, posreduje privzeto vrednost pdfuaid:rev 2024 in zapiše kataloški /Version /2.0, tako da ima postopno posodobljen izvorni PDF 1.x kot učinkovito različico PDF 2.0

Vrne True ob uspehu. Vrne False, če osnovni SaveAs ni uspel ali če postopne posodobitve ni bilo mogoče pripeti (prekratek PDF, neveljavna priponka, šifriran izvor).

• SaveAsPdfUa pripne oznake zapisnega formata, ki jih zahteva ISO 14289-1 — ne ustvari drevesa strukture, ne vdelava manjkajočih pisav, ne dodaja besedila Alt slikam in drugače ne spreminja vsebine strani. Avtorstvo označenega dokumenta (StructTreeRoot, Figure /Alt, tabela /TH /Scope itd.) je še vedno odgovornost klicatelja. Za prikaz odsotnosti teh vsebinskih zahtev uporabite ValidatePdfUa.
• Vstavitev je izključno aditivna: če izvor že nosi /MarkInfo, /ViewerPreferences ali /Lang, se ti vnosi ohranijo in jih SaveAsPdfUa ne prepisuje. /Metadata se vedno nadomesti z novim XMP PDF/UA.
• Šifriranih dokumentov ni mogoče shraniti kot PDF/UA. Po potrebi najprej pokličite SaveAs(..., saRemoveSecurity).
• Deluje na vsaki platformi, ki jo podpira PDFium Delphi Component, ker je naknadna obdelava implementirana v Pascalu in ni odvisna od izvozov DLL PDFium, razen bralnikov metapodatkov.