SaveAsPdfUa - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Čuva PDF/UA-1 podrazumevano ili PDF/UA-2 kada je konfigurisano kroz TPdfUaSaveOptions.PdfUa2

Syntax

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

Description

SaveAsPdfUa prvo izvrši regularni SaveAs, a zatim preko sačuvanih bajtova nanosi inkrementalno ažuriranje koje datoteku unapređuje u PDF/UA-1 ili PDF/UA-2 dokument. Post-procesiranje ubacuje četiri klase markera u sačuvani tok:

XMP tok metapodataka koji objavljuje PDF/UA identifikaciju (pdfuaid:part = 1) plus odgovarajući opis pdfaExtension:schemas, obavezan unos dc:title (ISO 14289-1 §7.1) i premošćena polja Info rečnika (Author, Subject, Producer, Keywords, CreationDate, ModDate itd.).
Katalog /MarkInfo << /Marked true /Suspects false >> kada izvorni katalog nema /MarkInfo unos (§7.1).
Katalog /ViewerPreferences << /DisplayDocTitle true >> kada izvor nema /ViewerPreferences unos (§7.1).
Katalog /Lang (xx) kada izvor nema /Lang, a Options.Language isporučuje BCP 47 oznaku (§7.2). Trailer takođe dobija niz /ID (ponovo iskorišćen iz FPDF_GetFileIdentifier kada je dostupan, u suprotnome izveden deterministički iz izvornih bajtova).

Izlaz ostaje bajt-identičan osnovnom SaveAs rezultatu do kraja originalnog PDF-a; dodaje se samo inkrementalno ažuriranje Čitaoci koji ne razumeju PDF/UA i dalje prikazuju datoteku tačno onako kako bi to učinio regularni SaveAs. Dva overload-a se razlikuju samo u načinu prosleđivanja konfiguracije: forma samo sa imenom datoteke koristi TPdfUaSaveOptions.Default sa automatskim popunjavanjem iz FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage, dok forma TPdfUaSaveOptions dozvoljava pozivaocu da pregazi Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, Language, DocumentId, InstanceId i pdfuaid identifikatore Part, Revision, Amd i Corr

TPdfUaSaveOptions.PdfUa2 bira Part 2, isporučuje podrazumevanu vrednost pdfuaid:rev 2024 i piše katalog /Version /2.0 tako da inkrementalno ažuriran PDF 1.x izvor kao efektivnu verziju ima PDF 2.0

Vraća True pri uspehu. Vraća False ako osnovni SaveAs nije uspeo ili ako inkrementalno ažuriranje nije moglo da se prikači (PDF prekratak, nevažeći trailer, šifrovan izvor).

Remarks

SaveAsPdfUa prikačuje markere formata datoteke koje zahteva ISO 14289-1 — on ne generiše stablo strukture, ne ugrađuje nedostajuće fontove, ne dodaje Alt tekst slikama niti na bilo koji drugi način menja sadržaj stranica. Autorstvo označenog dokumenta (StructTreeRoot, Figure /Alt, tabela /TH /Scope itd.) i dalje je odgovornost pozivaoca. Koristite ValidatePdfUa da ukažete na odsustvo tih zahteva na nivou sadržaja.
Ubrizgavanje je čisto aditivno: ako izvor već nosi /MarkInfo, /ViewerPreferences ili /Lang, ti unosi se čuvaju i SaveAsPdfUa ih ne prepisuje. /Metadata se uvek zamenjuje novim PDF/UA XMP-om.
Šifrovani dokumenti ne mogu da se sačuvaju kao PDF/UA. Ako je potrebno, prvo pozovite SaveAs(..., saRemoveSecurity).
Radi na svakoj platformi koju podržava PDFiumPas jer je post-procesiranje implementirano u Pascal-u i ne zavisi od PDFium DLL izvoza izvan čitača metapodataka.

Example

// 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;

SaveAsPdfUa metod

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also