SaveAsPdfE - TPdf - PDFiumPas

Cette entrée API conserve identifiants, signatures, blocs de code et termes PDF dans leur forme d’origine.

Composant: TPdf · Unité: PDFium

Enregistre le document courant en tant que fichier conforme PDF/E-1 en post-traitant le PDF de base avec une mise à jour incrémentielle qui injecte des marqueurs de format de fichier PDF/E-1 (ISO 24517-1:2008)

Syntaxe

function SaveAsPdfE(const FileName: string): Boolean; overload;
function SaveAsPdfE(const FileName: string; const Options: TPdfESaveOptions): Boolean; overload;

Description

SaveAsPdfE exécute d'abord SaveAs, puis superpose une mise à jour incrémentielle sur les octets enregistrés afin de promouvoir le fichier en archive PDF/E-1 (ISO 24517-1:2008, le format de document d'ingénierie dérivé de PDF 1.6). Le post-traitement injecte quatre classes de marqueurs dans le flux enregistré :

Un flux de métadonnées XMP qui déclare l'identification PDF/E (pdfe:ISO_PDFEVersion = "PDF/E-1") ainsi que la description pdfaExtension:schemas correspondante pour l'espace de noms pdfe, et les propriétés Dublin Core / xmp / pdf relayées héritées de ISO 19005-1 §6.7 via §13.1 (dc:title / dc:creator / dc:description / xmp:CreateDate / xmp:ModifyDate / xmp:MetadataDate / xmp:CreatorTool / pdf:Producer / pdf:Keywords)
Un Document Information Dictionary réécrit qui ajoute l'entrée obligatoire /ISO_PDFEVersion (PDF/E-1) exigée par la clause SHALL de §5. L'objet Info conserve son numéro d'objet d'origine ; les entrées Info émises par PDFium sont préservées telles quelles. Lorsque le trailer source ne contient pas de /Info, un nouveau dictionnaire Info est synthétisé et une nouvelle référence /Info est écrite dans le trailer
Un catalogue de document mis à jour avec une référence /Metadata pointant vers le nouveau flux XMP
Un tableau /ID de trailer (§6.2) : réutilisé à partir de FPDF_GetFileIdentifier lorsque le PDF source en porte déjà un, sinon dérivé de manière déterministe à partir des octets source

La sortie reste octet pour octet identique au résultat de base de SaveAs jusqu'à la fin du PDF original ; seule la mise à jour incrémentielle est ajoutée. Les lecteurs existants qui ne comprennent pas PDF/E affichent tout de même le fichier exactement comme SaveAs le ferait. Les deux surcharges ne diffèrent que par la façon dont la configuration est transmise : la forme réservée au nom de fichier utilise TPdfESaveOptions.Default avec remplissage automatique à partir de FPDF_GetMetaText et FPDF_GetFileIdentifier, tandis que la forme TPdfESaveOptions permet à l'appelant de remplacer Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, DocumentId, InstanceId et la chaîne Version (par défaut "PDF/E-1")

Renvoie True en cas de succès. Renvoie False si SaveAs de base a échoué ou si la mise à jour incrémentielle n'a pas pu être attachée (généralement un trailer invalide dans les octets enregistrés)

Remarques

SaveAsPdfE ajoute les marqueurs de format de fichier exigés par ISO 24517-1 — il n'incorpore pas les polices manquantes, ne supprime pas les XObject interdits, ne normalise pas les clés ExtGState et ne retire pas les formulaires XFA. Produire un document dont le contenu satisfait déjà PDF/E-1 (selon §7–§11) reste la responsabilité de l'appelant. Utilisez ValidatePdfE pour faire ressortir les problèmes au niveau du format de fichier que cette méthode traite ; associez-la à un validateur PDF/E externe (callas pdfaPilot, axesPDF, ...) pour les contrôles au niveau du contenu
Contrairement à PDF/A et PDF/UA, PDF/E-1 autorise le chiffrement (§6.3). Lorsque la source est chiffrée, le tableau /ID du trailer et les chaînes qu'il contient doivent être des objets directs ; SaveAsPdfE écrit /ID directement, ce qui satisfait cette contrainte
La réécriture du Document Information Dictionary est la première fois que le pipeline PDF/x de PDFiumPas modifie un objet Info existant. Le nouveau dictionnaire Info utilise le même numéro d'objet que la source, de sorte que les références xref / trailer /Info restent valides
L'URI de l'espace de noms pdfe utilisé par cette implémentation est http://www.aiim.org/pdfe/ns/id/ (convention de l'industrie AIIM, correspondant aux URI pdfa / pdfua). Le texte de ISO 24517-1:2008 §13.3 imprime cette URI sans l'une des lettres "i", ce qui semble être une faute de frappe. Remplacez-le via TPdfESaveOptions.Version si un validateur exige l'orthographe stricte de la spécification

Exemple

// Sortie PDF/E-1 simple, options renseignées automatiquement à partir du document
if Pdf1.SaveAsPdfE('C:\Drawing.pdfe.pdf') then
  ShowMessage('Saved PDF/E-1');

// Avec des options explicites (Title remplacé, Producer personnalisé)
var
  Opts: TPdfESaveOptions;
begin
  Opts := TPdfESaveOptions.Default;
  Opts.Title := 'Bridge Assembly Drawing - Sheet 12';
  Opts.Producer := 'PDFiumPas';
  Pdf1.SaveAsPdfE('C:\Bridge.pdfe.pdf', Opts);
end;

Voir aussi

SaveAsPdfEToStream, ValidatePdfE, PdfEConformance, SaveAsPdfA, SaveAsPdfUa