SaveAsPdfUa - TPdf - PDFium Delphi Component

Komponenta: TPdf · Jedinica: PDFium

Sprema PDF/UA-1 zadano ili PDF/UA-2 kada je konfigurirano kroz TPdfUaSaveOptions.PdfUa2

Sintaksa

function SaveAsPdfUa(const FileName: string): Boolean; overload;
function SaveAsPdfUa(const FileName: string; const Options: TPdfUaSaveOptions): Boolean; overload;

Opis

SaveAsPdfUa najprije izvodi uobičajeni SaveAs, a zatim nad spremljene bajtove nanosi inkrementalno ažuriranje koje datoteku promovira u PDF/UA-1 ili PDF/UA-2 dokument. Naknadna obrada ubacuje četiri klase oznaka u spremljeni tok:

XMP tok metapodataka koji deklarira PDF/UA identifikaciju (pdfuaid:part = 1) uz odgovarajući opis pdfaExtension:schemas, obavezni unos dc:title (ISO 14289-1 §7.1) i premošćena polja Info rječnika (Author, Subject, Producer, Keywords, CreationDate, ModDate itd.)
Kataloški unos /MarkInfo << /Marked true /Suspects false >> kad izvorni katalog nema unos /MarkInfo (§7.1)
Kataloški unos /ViewerPreferences << /DisplayDocTitle true >> kad izvor nema unos /ViewerPreferences (§7.1)
Kataloški unos /Lang (xx) kad izvor nema /Lang, a Options.Language dostavlja BCP 47 oznaku (§7.2). Trailer također dobiva niz /ID (preuzima se iz FPDF_GetFileIdentifier kad je dostupan, inače se izvodi deterministički iz izvornih bajtova)

Izlaz ostaje bajtovno identičan rezultatu osnovnog SaveAs sve do kraja izvornog PDF-a; nadodaje se samo inkrementalno ažuriranje pa čitači koji ne razumiju PDF/UA i dalje prikazuju datoteku točno onako kako bi to učinio uobičajeni SaveAs. Dva se preopterećenja razlikuju samo u načinu prosljeđivanja konfiguracije: oblik samo s imenom datoteke koristi TPdfUaSaveOptions.Default uz automatsko popunjavanje iz FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage, dok oblik s TPdfUaSaveOptions omogućuje pozivatelju nadjačavanje Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId te identifikatora pdfuaid Part, Revision, Amd i Corr

TPdfUaSaveOptions.PdfUa2 bira Part 2, isporučuje zadana vrijednost pdfuaid:rev 2024 i upisuje kataloški /Version /2.0 tako da izvor PDF 1.x s inkrementalnim ažuriranjem ima PDF 2.0 kao svoju djelotvornu verziju

Vraća True pri uspjehu. Vraća False ako osnovni SaveAs nije uspio ili ako inkrementalno ažuriranje nije moglo biti priloženo (prekratak PDF, neispravan trailer, šifrirani izvor)

Napomene

SaveAsPdfUa prilaže oznake formata datoteke potrebne prema ISO 14289-1 — ne generira stablo strukture, ne ugrađuje nedostajuće fontove, ne dodaje Alt tekst slikama i ne mijenja sadržaj stranica. Izrada označenog dokumenta (StructTreeRoot, Figure /Alt, tablica /TH /Scope itd.) i dalje je odgovornost pozivatelja. Koristite ValidatePdfUa za otkrivanje nedostatka tih zahtjeva na razini sadržaja
Ubacivanje je čisto aditivno: ako izvor već nosi /MarkInfo, /ViewerPreferences ili /Lang, ti se unosi čuvaju i SaveAsPdfUa ih ne prepisuje. /Metadata se uvijek zamjenjuje novim PDF/UA XMP-om
Šifrirani dokumenti ne mogu se spremiti kao PDF/UA. Ako je potrebno, prvo pozovite SaveAs(..., saRemoveSecurity)
Radi na svim platformama koje podržava PDFium Delphi Component jer je naknadna obrada implementirana u Pascalu i ne ovisi o izvozima PDFium DLL-a izvan čitača metapodataka

Primjer

// Simple PDF/UA-1 output, options auto-populated from the document
if Pdf1.SaveAsPdfUa('C:\Report.pdfua.pdf') then
  ShowMessage('Saved PDF/UA-1');

// With explicit options (Title overridden, language explicit)
var
  Opts: TPdfUaSaveOptions;
begin
  Opts := TPdfUaSaveOptions.Default;
  Opts.DocumentTitle := 'Quarterly Report Q3 2026';
  Opts.Language := 'en-US';
  Pdf1.SaveAsPdfUa('C:\Report.q3.pdfua.pdf', Opts);

// PDF/UA-2 output based on ISO 32000-2
  Opts := TPdfUaSaveOptions.PdfUa2;
  Opts.DocumentTitle := 'Accessible PDF 2.0 report';
  Opts.Language := 'en-US';
  Pdf1.SaveAsPdfUa('C:\Report.pdfua2.pdf', Opts);
end;

Vidi također