SaveAsPdfUa methode

Slaat het huidige document op als een PDF/UA-1-conform-bestand door nabewerking van de basis-PDF met een incrementele update die PDF/UA-bestandsformaatmarkeringen injecteert

SaveAsPdfUa voert eerst de reguliere SaveAs uit, waarna een incrementele update bovenop de opgeslagen bytes wordt gelaagde die het bestand tot een PDF/UA-1-archief promoveert (ISO 14289-1:2014). De nabewerking injecteert vier klassen van markeringen in de opgeslagen stroom:

• Een XMP-metagegevensstroom die PDF/UA-identificatie declareert (pdfuaid:part = 1) plus de overeenkomstige pdfaExtension:schemas-beschrijving, de verplichte vermelding dc:title (ISO 14289-1 §7.1), en gebridgde Info-woordenboekvelden (Author, Subject, Producer, Keywords, CreationDate, ModDate enz.).
• Catalogus /MarkInfo << /Marked true /Suspects false >> wanneer de broncatalogus geen /MarkInfo-vermelding heeft (§7.1).
• Catalogus /ViewerPreferences << /DisplayDocTitle true >> wanneer de bron geen /ViewerPreferences-vermelding heeft (§7.1).
• Catalogus /Lang (xx) wanneer de bron geen /Lang heeft en Options.Language een BCP 47-tag levert (§7.2). De trailer krijgt ook een /ID-array (hergebruikt vanuit FPDF_GetFileIdentifier indien beschikbaar, anders deterministisch afgeleid uit de bronbytes).

De uitvoer blijft byte-identiek aan het basis-SaveAs-resultaat tot aan het einde van de originele PDF; alleen de incrementele update wordt toegevoegd. Bestaande lezers die PDF/UA niet begrijpen renderen het bestand nog steeds exact zoals de reguliere SaveAs zou doen. De twee overloads verschillen alleen in hoe de configuratie wordt doorgegeven: de alleen-bestandsnaam-vorm gebruikt TPdfUaSaveOptions.Default met auto-vulling vanuit FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage, terwijl de TPdfUaSaveOptions-vorm de aanroeper laat Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId en de pdfuaid Part / Amd / Corr-identificatoren overschrijven.

Retourneert True bij succes. Retourneert False als de basis-SaveAs faalde of als de incrementele update niet kon worden bijgevoegd (PDF te kort, ongeldige trailer, versleutelde bron).

• SaveAsPdfUa voegt de bestandsformaatmarkeringen vereist door ISO 14289-1 toe — het genereert geen structuurboom, bedt geen ontbrekende lettertypen in, voegt geen Alt-tekst aan figuren toe, of wijzigt anderszins pagina-inhoud. Een getagd document auteren (StructTreeRoot, Figure /Alt, tabel /TH /Scope enz.) blijft de verantwoordelijkheid van de aanroeper. Gebruik ValidatePdfUa om de afwezigheid van die inhoudsniveau-vereisten te tonen.
• De injectie is puur additief: als de bron al /MarkInfo, /ViewerPreferences of /Lang draagt, worden die vermeldingen behouden en overschrijft SaveAsPdfUa ze niet. /Metadata wordt altijd vervangen door de nieuwe PDF/UA-XMP.
• Versleutelde documenten kunnen niet als PDF/UA worden opgeslagen. Roep eerst SaveAs(..., saRemoveSecurity) aan indien nodig.
• Werkt op elk platform ondersteund door PDFiumPas omdat de nabewerking in Pascal is geïmplementeerd en niet afhankelijk is van PDFium-DLL-exports buiten de metagegevensreaders.

SaveAsPdfUaToStream, ValidatePdfUa, PdfUaConformance, SaveAsPdfA, IsTagged