SaveAsPdfX method

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.

Saves the current document as a PDF/X-1a:2001, PDF/X-3:2002, or PDF/X-4 conformant file by post-processing the base PDF with an incremental update that injects PDF/X file-format markers (ISO 15930 family).

SaveAsPdfX performs the regular SaveAs first, then layers an incremental update on top of the saved bytes that promotes the file to PDF/X conformance — the ISO 15930 family of print-exchange standards used in the graphic arts industry. The post-processing injects five classes of bytes into the saved stream:

• An XMP metadata stream that declares PDF/X identification (pdfxid:GTS_PDFXVersion, plus pdfxid:GTS_PDFXConformance for PDF/X-1a / PDF/X-3) plus the matching pdfaExtension:schemas description for the pdfxid namespace, and bridged Dublin Core / xmp / pdf properties for Title / Author / Producer / dates.
• A rewritten Document Information Dictionary that adds the mandatory /GTS_PDFXVersion, the optional /GTS_PDFXConformance (PDF/X-1a / PDF/X-3 only; PDF/X-4 deprecates this entry), and a /Trapped name (defaults to /False). Existing Info entries (Title / Author / Subject / etc.) are preserved.
• An updated document catalog with /Metadata N 0 R and /OutputIntents [M 0 R] references.
• An OutputIntent dictionary with /Type /OutputIntent /S /GTS_PDFX and the required /OutputCondition / /OutputConditionIdentifier / /RegistryName / /Info entries, referring to an embedded ICC profile via /DestOutputProfile.
• The embedded ICC profile stream (sRGB IEC61966-2.1 by default, 3144 bytes; caller may supply a CMYK profile through Options.IccProfileData for commercial print).

The trailer is rewritten to add an /ID array. The output stays byte-identical to the base SaveAs result up to the end of the original PDF; only the incremental update is appended. The two overloads differ only in how the configuration is passed in: the file-name-only form uses TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) with auto-population of Info / DocumentId fields from FPDF_GetMetaText and FPDF_GetFileIdentifier.

Returns True on success. Returns False if the base SaveAs failed or if the incremental update could not be attached.

• SaveAsPdfX attaches the file-format markers required by ISO 15930 — it does not embed missing fonts, strip transparency for PDF/X-1a / PDF/X-3, remove JavaScript or visible annotations, or normalise OPI / Reference XObjects. Authoring a document whose page content already meets the chosen PDF/X conformance level is still the caller's responsibility. Use ValidatePdfX to surface the file-format-level issues this method addresses; pair with callas pdfaPilot or the Ghent PDF Workgroup Output Suite for content-level checks.
• The default ICC profile is sRGB — suitable for PDF/X-3 / PDF/X-4 RGB workflows but not typical for commercial CMYK print. Supply Options.IccProfileData with the ICC bytes for the target press characterisation (FOGRA39, ISO Coated v2, GRACoL2006_Coated1v2, JapanColor2011Coated, etc.) and update OutputConditionIdentifier / RegistryName / OutputIntentInfo accordingly.
• Encryption is forbidden by PDF/X. Call SaveAs(..., saRemoveSecurity) on encrypted sources before SaveAsPdfX.
• PDF/X-1a accepts only CMYK + spot colors and forbids transparency / layers; PDF/X-3 adds RGB / Lab / ICC-managed colors; PDF/X-4 additionally permits transparency, layers, JPEG2000, and OpenType fonts. SaveAsPdfX attaches the marker corresponding to Options.Conformance but cannot enforce these content-level rules. Confirm via preflight.

SaveAsPdfXToStream, ValidatePdfX, PdfXConformance, SaveAsPdfA, SaveAsPdfE