SaveAsPdfX - TPdf - PDFiumPas

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.

Componente: TPdf · Unidad: PDFium

Guarda el documento actual como un archivo conforme a PDF/X-1a:2001, PDF/X-3:2002 o PDF/X-4 mediante el posprocesado del PDF base con una actualización incremental que inyecta marcadores de formato de archivo PDF/X (familia ISO 15930)

Sintaxis

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

Descripción

SaveAsPdfX realiza primero el SaveAs normal y después superpone una actualización incremental sobre los bytes guardados que promociona el archivo a conformidad PDF/X — la familia de estándares de intercambio de impresión ISO 15930 usada en la industria de las artes gráficas. El posprocesado inyecta cinco clases de bytes en el flujo guardado:

Un flujo de metadatos XMP que declara la identificación PDF/X (pdfxid:GTS_PDFXVersion, más pdfxid:GTS_PDFXConformance para PDF/X-1a / PDF/X-3) junto con la descripción pdfaExtension:schemas correspondiente al espacio de nombres pdfxid, y propiedades enlazadas de Dublin Core / xmp / pdf para Title / Author / Producer / dates
Un diccionario de información del documento reescrito que añade el obligatorio /GTS_PDFXVersion, el opcional /GTS_PDFXConformance (solo PDF/X-1a / PDF/X-3; PDF/X-4 deja obsoleta esta entrada) y un nombre /Trapped (por defecto /False). Las entradas Info existentes (Title / Author / Subject / etc.) se preservan
Un catálogo de documento actualizado con referencias /Metadata N 0 R y /OutputIntents [M 0 R]
Un diccionario OutputIntent con /Type /OutputIntent /S /GTS_PDFX y las entradas obligatorias /OutputCondition / /OutputConditionIdentifier / /RegistryName / /Info, que apuntan a un perfil ICC incrustado mediante /DestOutputProfile
El flujo de perfil ICC incrustado (sRGB IEC61966-2.1 por defecto, 3144 bytes; quien llama puede suministrar un perfil CMYK mediante Options.IccProfileData para impresión comercial)

El trailer se reescribe para añadir un array /ID. La salida permanece idéntica en bytes al resultado base de SaveAs hasta el final del PDF original; solo se añade la actualización incremental. Las dos sobrecargas difieren solo en cómo se pasa la configuración: la forma de solo nombre de archivo usa TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) con autocompletado de los campos Info / DocumentId desde FPDF_GetMetaText y FPDF_GetFileIdentifier

Devuelve True si tiene éxito. Devuelve False si falló el SaveAs base o si no se pudo acoplar la actualización incremental

Notas

SaveAsPdfX adjunta los marcadores de formato de archivo requeridos por ISO 15930 — no incrusta fuentes ausentes, no elimina la transparencia para PDF/X-1a / PDF/X-3, no quita JavaScript ni anotaciones visibles ni normaliza OPI / Reference XObjects. Crear un documento cuyo contenido de página ya cumpla el nivel de conformidad PDF/X elegido sigue siendo responsabilidad de quien llama. Usa ValidatePdfX para mostrar los problemas a nivel de formato que este método cubre; combínalo con callas pdfaPilot o Ghent PDF Workgroup Output Suite para comprobaciones a nivel de contenido
El perfil ICC predeterminado es sRGB — adecuado para flujos RGB PDF/X-3 / PDF/X-4 pero no típico para impresión comercial CMYK. Suministra Options.IccProfileData con los bytes ICC para la caracterización de prensa objetivo (FOGRA39, ISO Coated v2, GRACoL2006_Coated1v2, JapanColor2011Coated, etc.) y actualiza OutputConditionIdentifier / RegistryName / OutputIntentInfo en consecuencia
PDF/X prohíbe el cifrado. Llama a SaveAs(..., saRemoveSecurity) sobre fuentes cifradas antes de SaveAsPdfX
PDF/X-1a acepta solo CMYK + colores planos y prohíbe transparencia / capas; PDF/X-3 añade colores RGB / Lab / gestionados por ICC; PDF/X-4 además permite transparencia, capas, JPEG2000 y fuentes OpenType. SaveAsPdfX adjunta el marcador correspondiente a Options.Conformance pero no puede hacer cumplir estas reglas a nivel de contenido. Confírmalo mediante preflight

Ejemplo

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

// PDF/X-1a con un perfil ICC CMYK personalizado (por ejemplo, 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;

Véase también

SaveAsPdfXToStream, ValidatePdfX, PdfXConformance, SaveAsPdfA, SaveAsPdfE