Довідник розробника PDFium Delphi Component

Component: TPdf · Unit: PDFium

Зберігає поточний документ як файл, сумісний з PDF/X-1a:2001, PDF/X-3:2002 або PDF/X-4, шляхом постобробки базового PDF інкрементальним оновленням, яке вставляє маркери формату PDF/X (сімейство ISO 15930).

Syntax

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

Description

SaveAsPdfX спочатку виконує звичайний SaveAs, а потім нашаровує поверх збережених байтів інкрементне оновлення, яке приводить файл до відповідності PDF/X — сімейства стандартів обміну для друку ISO 15930, що використовуються в індустрії графічного дизайну. Постобробка вставляє в збережений потік п’ять класів байтів:

Потік метаданих XMP, який заявляє ідентифікацію PDF/X (pdfxid:GTS_PDFXVersion, плюс pdfxid:GTS_PDFXConformance для PDF/X-1a / PDF/X-3), плюс відповідний опис pdfaExtension:schemas для простору імен pdfxid та перенесені властивості Dublin Core / xmp / pdf для Title / Author / Producer / дат
Переписаний Document Information Dictionary, який додає обов’язковий /GTS_PDFXVersion, необов’язковий /GTS_PDFXConformance (лише PDF/X-1a / PDF/X-3; PDF/X-4 оголошує цей запис застарілим) та ім’я /Trapped (типово /False). Наявні записи Info (Title / Author / Subject / ін.) зберігаються
Оновлений каталог із посиланнями /Metadata N 0 R і /OutputIntents [M 0 R]
Словник OutputIntent із /Type /OutputIntent /S /GTS_PDFX та обов’язковими записами /OutputCondition / /OutputConditionIdentifier / /RegistryName / /Info, що посилається на вбудований профіль ICC через /DestOutputProfile
Вбудований потік профілю ICC (типово sRGB IEC61966-2.1, 3144 bytes; викликувач може передати профіль CMYK через Options.IccProfileData для комерційного друку)

Трейлер переписується, щоб додати масив /ID. Вивід залишається побайтово ідентичним результату базового SaveAs аж до кінця початкового PDF; додається лише інкрементне оновлення. Два перевантаження відрізняються лише способом передачі конфігурації: форма лише з ім’ям файлу використовує TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) з автоматичним заповненням полів Info / DocumentId з FPDF_GetMetaText і FPDF_GetFileIdentifier

Повертає True у разі успіху. Повертає False, якщо базовий SaveAs завершився невдало або якщо інкрементне оновлення не вдалося додати

Remarks

SaveAsPdfX додає маркери формату файлу, вимагані ISO 15930 — він не вбудовує відсутні шрифти, не видаляє прозорість для PDF/X-1a / PDF/X-3, не вилучає JavaScript або видимі анотації і не нормалізує OPI / Reference XObjects. Підготувати документ, вміст сторінок якого вже відповідає обраному рівню відповідності PDF/X, як і раніше має той, хто викликає. Використовуйте ValidatePdfX, щоб показати проблеми рівня формату файлу, які вирішує цей метод; поєднуйте з callas pdfaPilot або Ghent PDF Workgroup Output Suite для перевірок рівня вмісту
Типовий профіль ICC — sRGB, що підходить для робочих процесів RGB PDF/X-3 / PDF/X-4, але не є типовим для комерційного CMYK-друку. Передайте в Options.IccProfileData байти ICC для характеристики цільової друкарської машини (FOGRA39, ISO Coated v2, GRACoL2006_Coated1v2, JapanColor2011Coated, ін.) і відповідно оновіть OutputConditionIdentifier / RegistryName / OutputIntentInfo
Шифрування заборонено PDF/X. Викличте SaveAs(..., saRemoveSecurity) на зашифрованих джерелах перед SaveAsPdfX
PDF/X-1a приймає лише CMYK + плашкові кольори та забороняє прозорість / шари; PDF/X-3 додає RGB / Lab / кольори з керуванням ICC; PDF/X-4 додатково дозволяє прозорість, шари, JPEG2000 та шрифти OpenType. SaveAsPdfX додає маркер, що відповідає Options.Conformance, але не може застосувати ці правила рівня вмісту. Підтвердьте переддрукарською перевіркою

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 метод

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also