function SaveAsPdfA(const FileName: string; Conformance: TPdfAConformance = pac1b): Boolean; overload;
function SaveAsPdfA(const FileName: string; const Options: TPdfASaveOptions): Boolean; overload;
SaveAsPdfA performs the regular SaveAs first, then layers an incremental update on top of the saved bytes that promotes the file to a PDF/A archive (PDF/A-1b by default; ISO 19005-1, with Cor.1:2007). The post-processing injects four things into the saved stream:
pdfaid:part = 1, pdfaid:conformance = B), mirrors every Document Information Dictionary entry into its XMP equivalent (Title → dc:title, Author → dc:creator, Subject → dc:description, Keywords → pdf:Keywords, Creator → xmp:CreatorTool, Producer → pdf:Producer, CreationDate → xmp:CreateDate, ModDate → xmp:ModifyDate) as required by ISO 19005-1 6.7.3, and embeds the pdfaid extension schema description required by 6.7.8 / Cor.1.TPdfASaveOptions.IccProfileData./ID array in the trailer (mandatory per ISO 19005-1 6.1.3). When the source PDF already carries a file identifier, the existing 16-byte permanent and changing IDs are reused; otherwise a deterministic 16-byte fallback ID is derived from the source bytes.The output stays byte-identical to the base SaveAs result up to the
end of the original PDF; only the incremental update is appended
Existing readers that don't understand PDF/A still render the file
exactly as the regular SaveAs would. The two overloads differ only
in how the conformance / options are passed in — the
TPdfAConformance form is shorthand for the common case
(pac1b); the TPdfASaveOptions form takes a
record with the full configuration surface, including optional
overrides for Title, Author, Subject, Keywords, Creator, Producer,
CreationDate, ModDate, DocumentId, and InstanceId. Fields left empty
are auto-populated from FPDF_GetMetaText /
FPDF_GetFileIdentifier, so the typical caller does not
need to set any field other than Conformance.
The Conformance value selects the target standard and
level. PDF/A-1 (ISO 19005-1) offers pac1b and
pac1a; PDF/A-2 (ISO 19005-2) and PDF/A-3 (ISO 19005-3)
add levels b, u and a as pac2b / pac2u /
pac2a and pac3b / pac3u /
pac3a. The injected pdfaid:part (1, 2 or 3)
and pdfaid:conformance (A, B or U) follow the requested
value, while the OutputIntent keeps the GTS_PDFA1 subtype
that ISO 19005-2 retains for every part. Because the post-processor
cannot synthesize logical structure, a Level A request
(pac1a / pac2a / pac3a) is
automatically downgraded to the matching Level B when the source lacks
the tagged-PDF structure that level requires — so the saved file
never makes a false Level A claim.
Returns True on success. Returns False if
the base SaveAs failed, if the incremental update could not be
attached (PDF too short, invalid trailer), or if the ICC profile
data was provided but failed validation.
/Encrypt key. (Internally the base save runs with saRemoveSecurity.)ValidatePdfA after the save to inspect the result and surface any remaining issues to operators.
// Simple PDF/A-1b output using the bundled sRGB profile
if Pdf1.SaveAsPdfA('C:\Report.pdfa.pdf') then
ShowMessage('Saved PDF/A-1b');
// With a custom ICC profile
var
Opts: TPdfASaveOptions;
begin
Opts := Default(TPdfASaveOptions);
Opts.Conformance := pac1b;
Opts.IccProfileData := TFile.ReadAllBytes('C:\Profiles\Coated.icc');
Pdf1.SaveAsPdfA('C:\Report.cmyk.pdfa.pdf', Opts);
end;