SaveAsPdfX - TPdf - PDFiumPas

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.

المكون: TPdf · الوحدة: PDFium

يحفظ المستند الحالي كملف متوافق مع PDF/X-1a:2001 أو PDF/X-3:2002 أو PDF/X-4 عبر معالجة PDF الأساسي بتحديث تزايدي يحقن علامات تنسيق ملف PDF/X (عائلة ISO 15930)

الصياغة

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

الوصف

ينفذ 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 المجسرة للعنوان / المؤلف / المنتج / التواريخ.
قاموس معلومات مستند مُعاد كتابته يضيف /GTS_PDFXVersion الإلزامي، و /GTS_PDFXConformance الاختياري (PDF/X-1a / PDF/X-3 فقط؛ يستنكر PDF/X-4 هذا الإدخال)، واسم /Trapped (الافتراضي هو /False). يتم الاحتفاظ بإدخالات المعلومات الحالية (العنوان / المؤلف / الموضوع / إلخ).
كتالوج مستند مُحدّث بمراجع /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 بايت؛ يمكن للمتصل توفير ملف تعريف CMYK من خلال Options.IccProfileData للطباعة التجارية).

تتم إعادة كتابة المقطورة لإضافة مصفوفة /ID. يبقى المخرج متطابقًا بالبايت مع النتيجة الأساسية لـ SaveAs حتى نهاية ملف PDF الأصلي؛ يتم إلحاق التحديث التزايدي فقط. يختلف المتغيران المحملان زائدًا فقط في كيفية تمرير التكوين: يستخدم النموذج الذي يحتوي على اسم الملف فقط TPdfXSaveOptions.Default (PDF/X-4 + sRGB + /Trapped /False) مع التعبئة التلقائية لحقول Info / DocumentId من FPDF_GetMetaText و FPDF_GetFileIdentifier.

يُرجع True عند النجاح. يُرجع False إذا فشل الحفظ كـ (SaveAs) الأساسي أو إذا لم يكن من الممكن إرفاق التحديث التزايدي.

ملاحظات

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.
ملف تعريف ICC الافتراضي هو sRGB — مناسب لسير عمل PDF/X-3 / PDF/X-4 RGB ولكنه ليس نموذجيًا لطباعة CMYK التجارية. قم بتزويد Options.IccProfileData ببايتات ICC لتوصيف المطبعة الهدف (FOGRA39، ISO Coated v2، GRACoL2006_Coated1v2، JapanColor2011Coated، إلخ) وقم بتحديث OutputConditionIdentifier / RegistryName / OutputIntentInfo وفقًا لذلك.
التشفير ممنوع بواسطة PDF/X. اتصل بـ SaveAs(..., saRemoveSecurity) على المصادر المشفرة قبل SaveAsPdfX.
يقبل PDF/X-1a فقط ألوان CMYK + ألوان التركيز (spot colors) ويمنع الشفافية / الطبقات؛ يضيف PDF/X-3 ألوان RGB / Lab / ICC المدارة؛ بالإضافة إلى ذلك، يسمح PDF/X-4 بالشفافية والطبقات و JPEG2000 وخطوط OpenType. يُلحق SaveAsPdfX العلامة المطابقة لـ Options.Conformance ولكنه لا يمكنه فرض هذه القواعد على مستوى المحتوى. تأكد عبر اختبار ما قبل الطباعة (preflight).

مثال

// PDF/X-4 بسيط مع حزمة sRGB OutputIntent
if Pdf1.SaveAsPdfX('C:\AdProof.pdfx.pdf') then
  ShowMessage('تم حفظ PDF/X-4');

// PDF/X-1a مع ملف تعريف CMYK ICC مخصص (على سبيل المثال 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;

انظر أيضا

SaveAsPdfXToStream, ValidatePdfX, PdfXConformance, SaveAsPdfA, SaveAsPdfE