SaveAsPdfX - TPdf - PDFium Delphi Component

Composant: TPdf · Unit: PDFium

Enregistre un candidat PDF/X avec les métadonnées d'identification et un profil de sortie incorporé pour la variante ISO 15930 choisie

Syntax

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

Description

SaveAsPdfX exécute d'abord le SaveAs ordinaire, puis superpose une mise à jour incrémentielle sur les octets enregistrés pour la variante d'échange d'impression PDF/X choisie. 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 de condition de sortie configurées, référençant un profil ICC incorporé via /DestOutputProfile
Le flux de profil ICC incorporé : PDF/X-1a exige un profil de sortie CMYK fourni par l'appelant ; PDF/X-3, PDF/X-4 et PDF/X-6 conservent la valeur par défaut sRGB livrée avec le composant

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 une fois les octets préparés écrits, ou False si le document est inactif ou si la sauvegarde de base échoue Une sérialisation réussie n'établit pas une conformité PDF/X complète

Pour pxc1a, IccProfileData doit contenir un profil de sortie ICC v2 structurellement valide, avec une classe de périphérique prtr, un espace de couleur de données CMYK, un PCS Lab ou XYZ et les LUT bidirectionnelles requises Des données de profil absentes, RGB, tronquées, mal classées ou non prises en charge lèvent EArgumentException ; il n'existe aucun repli sRGB pour PDF/X-1a

Pour PDF/X-1a, les valeurs OutputCondition, OutputConditionIdentifier et OutputIntentInfo encore égales à la valeur par défaut intégrée sRGB IEC61966-2.1 sont remplacées par la description du profil vérifié Si le profil n'a pas de description, fournissez un OutputConditionIdentifier non vide et non par défaut ; il fournit le libellé de remplacement, sinon l'appel lève EArgumentException Les libellés explicites de l'appelant sont préservés

La sérialisation et ces vérifications de profil s'achèvent dans un magasin de sauvegarde temporaire avant que le fichier cible ne soit ouvert en écriture Une cible existante reste donc inchangée si la validation du profil lève une exception ou si la sauvegarde de base échoue Ce n'est pas une garantie de remplacement de fichier atomique : un échec d'E/S après l'ouverture de la cible peut laisser une sortie partielle

Remarks

SaveAsPdfX attache les marqueurs de format de fichier exigés par ISO 15930 — il n’intègre pas les polices manquantes, ne supprime pas la transparence pour PDF/X-1a / PDF/X-3, ne supprime pas le JavaScript ni les annotations visibles, et ne normalise pas les OPI / Reference XObjects. La création d’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 remonter les problèmes au niveau format de fichier traités par cette méthode ; associez-le à callas pdfaPilot ou au Ghent PDF Workgroup Output Suite pour les vérifications au niveau contenu
Incorporer un profil de sortie ne convertit pas les objets RGB en CMYK et ne vérifie pas la condition d’impression physique ; préparez les couleurs de page pour le procédé de sortie choisi et utilisez un outil de préflight dédié pour des vérifications de conformité complètes
Le chiffrement est interdit par PDF/X ; la sauvegarde de base utilise saRemoveSecurity avant l’injection des marqueurs
PDF/X-1a n’accepte que les couleurs CMYK + tons directs et interdit la transparence / les couches ; PDF/X-3 ajoute les couleurs RGB / Lab / gérées par ICC ; PDF/X-4 autorise en plus la transparence, les couches, JPEG2000 et les polices OpenType. SaveAsPdfX attache le marqueur correspondant à Options.Conformance mais ne peut pas appliquer ces règles au niveau contenu. Confirmez via préflight

Example

// Simple PDF/X-4 with bundled sRGB OutputIntent
if Pdf1.SaveAsPdfX('C:\AdProof.pdfx.pdf') then
  ShowMessage('Saved PDF/X-4');

// PDF/X-1a with a custom CMYK ICC profile (e.g. 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;

SaveAsPdfX Méthode

Composant: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also