AddAlternateImage

معالجة الصور، المحتوى الاختياري

الوصف

يضيف أو يحدّث تمثيلًا بديلًا واحدًا لـ XObject صورة أساسية كما عُرّف في ISO 32000-1 §8.9.5.4

يمكن للصور البديلة توفير تمثيل طباعة عالي الدقة أو تمثيل عرض يتحكم فيه المحتوى الاختياري دون تكرار محتوى الصفحة

الصيغة

Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;

المعاملات

BaseImageIDالصورة المستخدمة من موارد الصفحة وعوامل Do في تدفق المحتوى
AlternateImageIDXObject الصورة المطلوب إلحاقه كمتغير variant
DefaultForPrintingيميز هذا المتغير كصورة الطباعة المفضلة ويمسح ذلك العلم من متغيرات أخرى لنفس الصورة الأساسية
OptionalContentIDمقبض OCG أو OCMD اختياري يتحكم في اختيار هذا المتغير، أو 0 لعدم وجود شرط محتوى اختياري

القيمة المُرجعة

تُرجع فهرس البديل الذي يبدأ من 1 شاملًا الفهرس القائم عندما تُحدَّث الصورة نفسها، أو 0 عند فشل التحقق

ملاحظات

يجب أن يكون الأساس والبديل كائنَي صورة مختلفين في المستند المحدد

الصورة المستخدمة بديلًا سابقًا لا يمكن أن تملك مصفوفة /Alternates خاصة بها، والصورة المالكة لبدائل لا يمكن إرفاقها بديلًا آخر

ترفع تمريرة OCG أو OCMD الحد الأدنى لإصدار PDF إلى 1.5؛ وإلا كان الحد الأدنى PDF 1.3

يجب أن يكون الأساس والبديل كائنَي صورة مختلفين في المستند المحددلا يمكن لصورة مستخدمة سلفًا كبديل أن تملك مصفوفة /Alternates خاصة بها، ولا يمكن لصورة تملك بدائل أن تُلحق كبديل آخريمرر OCG أو OCMD يرفع الحد الأدنى لإصدار PDF إلى 1.5؛ وإلا فالحد الأدنى للإصدار PDF 1.3

ترفض جميع أوضاع PDF/A العملية لأن ISO 19005 يحظر /OC في قواميس الصورعندما تكون للصورة الأساسية مدخل /OC يعرض العارض المدمج الأساسية أثناء ظهورها وسوا ذلك يختار أول بديل مرئي يكون مدخله

مثال

BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);

انظر أيضًا

AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo