SaveAsPdfX - TPdf - PDFiumPas

Component: TPdf · Unit: PDFium

Zapisuje bieżący dokument jako plik zgodny z PDF/X-1a:2001, PDF/X-3:2002 albo PDF/X-4 przez przetworzenie bazowego PDF przyrostową aktualizacją, która wstrzykuje znaczniki formatu PDF/X (rodzina ISO 15930)

Syntax

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

Description

SaveAsPdfX wykonuje najpierw zwykłe SaveAs, a następnie nakłada na zapisane bajty przyrostową aktualizację, która promuje plik do zgodności z PDF/X — rodziną standardów ISO 15930 do wymiany poligrafią, używaną w przemyśle graficznym. Postprocessing wstrzykuje do zapisanego strumienia pięć klas bajtów:

Strumień metadanych XMP deklarujący identyfikację PDF/X (pdfxid:GTS_PDFXVersion, plus pdfxid:GTS_PDFXConformance dla PDF/X-1a / PDF/X-3) wraz z pasującym opisem pdfaExtension:schemas dla przestrzeni nazw pdfxid oraz mostkowanymi właściwościami Dublin Core / xmp / pdf dla Title / Author / Producer / dat
Przepisany Document Information Dictionary, który dodaje obowiązkowy /GTS_PDFXVersion, opcjonalny /GTS_PDFXConformance (tylko PDF/X-1a / PDF/X-3; PDF/X-4 dezaktualizuje ten wpis) oraz nazwę /Trapped (domyślnie /False). Istniejące wpisy Info (Title / Author / Subject / itd.) są zachowywane
Zaktualizowany katalog dokumentu z odwołaniami /Metadata N 0 R i /OutputIntents [M 0 R]
Słownik OutputIntent z /Type /OutputIntent /S /GTS_PDFX i wymaganymi wpisami /OutputCondition / /OutputConditionIdentifier / /RegistryName / /Info, odwołujący się do osadzonego profilu ICC przez /DestOutputProfile
Osadzony strumień profilu ICC (domyślnie sRGB IEC61966-2.1, 3144 bajtów; wywołujący może dostarczyć profil CMYK przez Options.IccProfileData dla druku komercyjnego)

Trailer jest przepisywany, aby dodać tablicę /ID. Wyjście pozostaje identyczne bajt po bajcie z wynikiem bazowego SaveAs aż do końca pierwotnego PDF; doklejana jest jedynie przyrostowa aktualizacja. Dwa przeciążenia różnią się jedynie sposobem przekazania konfiguracji: forma wyłącznie z nazwą pliku używa TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) z automatycznym wypełnieniem pól Info / DocumentId z FPDF_GetMetaText i FPDF_GetFileIdentifier

Zwraca True w przypadku powodzenia. Zwraca False, gdy bazowe SaveAs nie powiodło się albo gdy przyrostowa aktualizacja nie mogła zostać dołączona

Remarks

SaveAsPdfX dołącza znaczniki formatu pliku wymagane przez ISO 15930 — nie osadza brakujących fontów, nie usuwa przezroczystości dla PDF/X-1a / PDF/X-3, nie usuwa JavaScriptu ani widocznych adnotacji ani nie normalizuje OPI / Reference XObjects. Przygotowanie dokumentu, którego zawartość stron już spełnia wybrany poziom zgodności PDF/X, nadal spoczywa na wywołującym. Użyj ValidatePdfX, aby ujawnić problemy na poziomie formatu pliku, którymi zajmuje się ta metoda; do kontroli na poziomie zawartości połącz z callas pdfaPilot lub Ghent PDF Workgroup Output Suite
Domyślny profil ICC to sRGB — odpowiedni dla przepływów RGB PDF/X-3 / PDF/X-4, ale nie typowy dla komercyjnego druku CMYK. Dostarcz Options.IccProfileData z bajtami ICC dla charakteryzacji docelowej prasy (FOGRA39, ISO Coated v2, GRACoL2006_Coated1v2, JapanColor2011Coated itd.) i odpowiednio zaktualizuj OutputConditionIdentifier / RegistryName / OutputIntentInfo
Szyfrowanie jest zabronione przez PDF/X. Wywołaj SaveAs(..., saRemoveSecurity) na zaszyfrowanych źródłach przed SaveAsPdfX
PDF/X-1a akceptuje tylko kolory CMYK + spot i zakazuje przezroczystości / warstw; PDF/X-3 dodaje kolory RGB / Lab / zarządzane przez ICC; PDF/X-4 dodatkowo dopuszcza przezroczystość, warstwy, JPEG2000 i fonty OpenType. SaveAsPdfX dołącza znacznik odpowiadający Options.Conformance, ale nie może wymusić tych reguł na poziomie zawartości. Potwierdź przez preflight

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 Metoda

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also