SaveAsPdfX - 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/X-1a:2001, PDF/X-3:2002 ou PDF/X-4 en post-traitant le PDF de base avec une mise à jour incrémentielle qui injecte des marqueurs de format de fichier PDF/X (famille ISO 15930)

Syntaxe

function SaveAsPdfX(const FileName: string): Boolean; overload;
function SaveAsPdfX(const FileName: string; const Options: TPdfXSaveOptions): Boolean; overload;

Description

SaveAsPdfX exécute d'abord SaveAs, puis superpose une mise à jour incrémentielle sur les octets enregistrés afin de promouvoir le fichier vers la conformité PDF/X — la famille ISO 15930 des normes d'échange d'impression utilisées dans l'industrie des arts graphiques. Le post-traitement injecte cinq classes d'octets dans le flux enregistré :

Un flux de métadonnées XMP qui déclare l'identification PDF/X (pdfxid:GTS_PDFXVersion, plus pdfxid:GTS_PDFXConformance pour PDF/X-1a / PDF/X-3) ainsi que la description pdfaExtension:schemas correspondante pour l'espace de noms pdfxid, et les propriétés Dublin Core / xmp / pdf relayées pour Title / Author / Producer / dates
Un Document Information Dictionary réécrit qui ajoute le /GTS_PDFXVersion obligatoire, le /GTS_PDFXConformance facultatif (PDF/X-1a / PDF/X-3 uniquement ; PDF/X-4 déprécie cette entrée) et un nom /Trapped (par défaut /False). Les entrées Info existantes (Title / Author / Subject / etc.) sont préservées
Un catalogue de document mis à jour avec des références /Metadata N 0 R et /OutputIntents [M 0 R]
Un dictionnaire OutputIntent avec /Type /OutputIntent /S /GTS_PDFX et les entrées /OutputCondition / /OutputConditionIdentifier / /RegistryName / /Info requises, référençant un profil ICC incorporé via /DestOutputProfile
Le flux de profil ICC incorporé (sRGB IEC61966-2.1 par défaut, 3144 bytes ; l'appelant peut fournir un profil CMYK via Options.IccProfileData pour l'impression commerciale)

Le trailer est réécrit pour ajouter un tableau /ID. 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 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 TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) avec remplissage automatique des champs Info / DocumentId à partir de FPDF_GetMetaText et FPDF_GetFileIdentifier

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

Remarques

SaveAsPdfX attache les marqueurs de format de fichier exigés par ISO 15930 — il n'incorpore pas les polices manquantes, ne supprime pas la transparence pour PDF/X-1a / PDF/X-3, ne retire pas JavaScript ou les annotations visibles et ne normalise pas OPI / Reference XObjects. Produire un document dont le contenu de page satisfait déjà le niveau de conformité PDF/X choisi reste la responsabilité de l'appelant. Utilisez ValidatePdfX pour faire ressortir les problèmes au niveau du format de fichier traités par cette méthode ; associez-la à callas pdfaPilot ou Ghent PDF Workgroup Output Suite pour les contrôles au niveau du contenu
Le profil ICC par défaut est sRGB — adapté aux flux PDF/X-3 / PDF/X-4 RGB mais pas typique pour l'impression commerciale CMYK. Fournissez Options.IccProfileData avec les octets ICC correspondant à la caractérisation presse cible (FOGRA39, ISO Coated v2, GRACoL2006_Coated1v2, JapanColor2011Coated, etc.) et mettez à jour OutputConditionIdentifier / RegistryName / OutputIntentInfo en conséquence
Le chiffrement est interdit par PDF/X. Appelez SaveAs(..., saRemoveSecurity) sur les sources chiffrées avant SaveAsPdfX
PDF/X-1a n'accepte que les couleurs CMYK + tons directs et interdit la transparence / les calques ; PDF/X-3 ajoute les couleurs RGB / Lab / gérées par ICC ; PDF/X-4 autorise en outre la transparence, les calques, JPEG2000 et les polices OpenType. SaveAsPdfX attache le marqueur correspondant à Options.Conformance mais ne peut pas imposer ces règles au niveau du contenu. Vérifiez via preflight

Exemple

// PDF/X-4 simple avec l'OutputIntent sRGB fourni
if Pdf1.SaveAsPdfX('C:\AdProof.pdfx.pdf') then
  ShowMessage('Saved PDF/X-4');

// PDF/X-1a avec un profil ICC CMYK personnalisé (par exemple FOGRA39)
var
  Opts: TPdfXSaveOptions;
begin
  Opts := TPdfXSaveOptions.Default;
  Opts.Conformance := pxc1a;
  Opts.IccProfileData := TFile.ReadAllBytes('C:\ICC\FOGRA39.icc');
  Opts.OutputCondition := 'Coated FOGRA39 (ISO 12647-2:2004)';
  Opts.OutputConditionIdentifier:= 'FOGRA39';
  Opts.RegistryName := 'http://www.color.org';
  Opts.Trapped := ptFalse;
  Pdf1.SaveAsPdfX('C:\AdProof.cmyk.pdfx.pdf', Opts);
end;

Voir aussi

SaveAsPdfXToStream, ValidatePdfX, PdfXConformance, SaveAsPdfA, SaveAsPdfE