SaveAsPdfE Metodo

SaveAsPdfE esegue prima il normale SaveAs, poi sovrappone un aggiornamento incrementale ai byte salvati che promuove il file a un archivio PDF/E-1 (ISO 24517-1:2008, il formato per documenti di ingegneria derivato da PDF 1.6). Il post-processing inietta quattro classi di marcature nello stream salvato:

• Uno stream di metadati XMP che dichiara l'identificazione PDF/E (pdfe:ISO_PDFEVersion = "PDF/E-1") più la descrizione pdfaExtension:schemas corrispondente per il namespace pdfe, e le proprietà Dublin Core / xmp / pdf travasate da ISO 19005-1 §6.7 tramite §13.1 (dc:title / dc:creator / dc:description / xmp:CreateDate / xmp:ModifyDate / xmp:MetadataDate / xmp:CreatorTool / pdf:Producer / pdf:Keywords)
• Un Document Information Dictionary riscritto che aggiunge la voce obbligatoria /ISO_PDFEVersion (PDF/E-1) richiesta dalla clausola SHALL del §5. L'oggetto Info conserva il suo numero d'oggetto originale; le voci Info emesse da PDFium restano intatte. Quando il trailer della sorgente non porta /Info, viene sintetizzato un nuovo dizionario Info e una nuova referenza /Info viene scritta nel trailer
• Un catalogo del documento aggiornato con una referenza /Metadata che punta al nuovo stream XMP
• Un array /ID nel trailer (§6.2): riusato da FPDF_GetFileIdentifier quando il PDF sorgente ne ha già uno, altrimenti derivato in modo deterministico dai byte sorgente

L'output resta byte-identico al risultato del SaveAs base fino alla fine del PDF originale; viene appeso solo l'aggiornamento incrementale I reader esistenti che non capiscono PDF/E continuano a renderizzare il file esattamente come farebbe il normale SaveAs. I due overload differiscono solo nel modo in cui la configurazione viene passata: la forma con solo nome file usa TPdfESaveOptions.Default con auto-popolamento da FPDF_GetMetaText e FPDF_GetFileIdentifier, mentre la forma con TPdfESaveOptions permette al chiamante di intervenire su Title, Author, Subject, Keywords, Creator, Producer, CreationDate, ModDate, DocumentId, InstanceId e sulla stringa Version (predefinita "PDF/E-1")

Restituisce True in caso di successo. Restituisce False se il SaveAs base è fallito o se l'aggiornamento incrementale non ha potuto essere applicato (tipicamente un trailer non valido nei byte salvati)

• SaveAsPdfE applica le marcature di formato file richieste da ISO 24517-1 — non incorpora i font mancanti, non rimuove gli XObject vietati, non normalizza le chiavi ExtGState né elimina i moduli XFA. Creare un documento il cui contenuto soddisfa già PDF/E-1 (secondo §7–§11) resta responsabilità del chiamante. Usa ValidatePdfE per far emergere le problematiche a livello di formato file che questo metodo affronta; abbinalo a un validatore PDF/E esterno (callas pdfaPilot, axesPDF, ...) per i controlli a livello di contenuto
• A differenza di PDF/A e PDF/UA, PDF/E-1 consente la crittografia (§6.3). Quando la sorgente è crittografata, l'array /ID del trailer e le stringhe al suo interno devono essere oggetti diretti; SaveAsPdfE scrive l'/ID direttamente, soddisfacendo quel vincolo
• La riscrittura del dizionario Info è la prima volta che la pipeline PDF/x di PDFium Delphi Component modifica un oggetto Info esistente. Il nuovo dizionario Info usa lo stesso numero d'oggetto della sorgente, così i riferimenti xref / trailer /Info restano validi
• L'URI del namespace pdfe usato da questa implementazione è http://www.aiim.org/pdfe/ns/id/ (convenzione di settore AIIM, in linea con gli URI pdfa / pdfua). Il testo di ISO 24517-1:2008 §13.3 riporta questo URI senza una delle lettere "i", il che sembra un errore tipografico. Intervieni via TPdfESaveOptions.Version se un validatore esige la grafia rigorosa della specifica