AddImageFromFile

معالجة الصور

الوصف

يضيف إجراءً إلى حقل النموذج المحدد يرتبط بعنوان على الإنترنت

بمجرد إضافة الصورة إلى المستند يمكن رسمها على أي صفحة عدة مرات دون زيادة إضافية في حجم ملف PDF

أنواع ملفات الصور المدعومة هي BMP وTIFF وJPEG وPNG وGIF وWMF وEMF وWebP، إضافة إلى AVIF وHEIF وHEIC وJPEG XL عند توفر مفكك صور حديث

سلوك إصدار PDF: يتطلب استيراد بيانات الصور 16-bit-per-component استخدام PDF 1.5. عندما يُضبط المستند على PDF 1.4 أو إصدار أقل ولا يكون إصدار الحفظ مقفّلًا، ترفع AddImageFromFile إصدار المستند تلقائيًا إلى PDF 1.5 وتسجل 16-bit image samples في AutoBumpedFeatures. وإذا قفل المستدعي إصدار حفظ أقل، ترفض بوابة التوافق عملية الحفظ مع LastErrorCode 602

مع صور BMP وTIFF يمكن استدعاء الدالة CompressImages قبل استدعاء هذه الدالة لضغط بيانات الصورة. أما أنواع الصور الأخرى فتُضغط تلقائيًا

الصيغة

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

المعاملات

FileName	اسم ملف الصورة المطلوب إضافتها
Options	في صور TIFF متعددة الصفحات يحدد هذا المعامل رقم الصفحة المطلوب تحميلها. وفي صور PNG: 0 = تحميل الصورة كالمعتاد 1 = تحميل قناة ألفا كصورة تدرّج رمادي 2 = تحميل الصورة مع قناة ألفا (بتقييد ألفا إلى 8 بت) 3 = تحميل الصورة (بتقييد الصورة إلى 8 بت/قناة) 4 = تحميل قناة ألفا (بتقييدها إلى 8 بت/قناة) 5 = تحميل الصورة مع قناة ألفا (بتقييد كلتيهما إلى 8 بت/قناة) 6 = تحميل الصورة مع قناة ألفا 7 = تحميل الصورة مع ملف جانبي لألوان ICC 8 = تحميل الصورة وقناة ألفا وملف جانبي لألوان ICC مع الاحتفاظ بعمق بت عالٍ أما أنواع الصور الأخرى فيجب تعيين هذا المعامل على 0 لها. وسيؤدي تعيين Options على -1 إلى فرض تحميل صور TIFF وEMF وWMF باستخدام مكتبة رسومات GDI+. ويمكن أيضًا تحميل صور TIFF متعددة الصفحات باستخدام GDI+ بتعيين المعامل Options على -PageNumber (مثلًا -3 للصفحة 3)

FileName

اسم ملف الصورة المطلوب إضافتها

Options

في صور TIFF متعددة الصفحات يحدد هذا المعامل رقم الصفحة المطلوب تحميلها. وفي صور PNG: 0 = تحميل الصورة كالمعتاد 1 = تحميل قناة ألفا كصورة تدرّج رمادي 2 = تحميل الصورة مع قناة ألفا (بتقييد ألفا إلى 8 بت) 3 = تحميل الصورة (بتقييد الصورة إلى 8 بت/قناة) 4 = تحميل قناة ألفا (بتقييدها إلى 8 بت/قناة) 5 = تحميل الصورة مع قناة ألفا (بتقييد كلتيهما إلى 8 بت/قناة) 6 = تحميل الصورة مع قناة ألفا 7 = تحميل الصورة مع ملف جانبي لألوان ICC 8 = تحميل الصورة وقناة ألفا وملف جانبي لألوان ICC مع الاحتفاظ بعمق بت عالٍ أما أنواع الصور الأخرى فيجب تعيين هذا المعامل على 0 لها. وسيؤدي تعيين Options على -1 إلى فرض تحميل صور TIFF وEMF وWMF باستخدام مكتبة رسومات GDI+. ويمكن أيضًا تحميل صور TIFF متعددة الصفحات باستخدام GDI+ بتعيين المعامل Options على -PageNumber (مثلًا -3 للصفحة 3)

قيم الإرجاع

0	تعذّرت إضافة الصورة. إما أنها لم تُعثر عليها أو أنها بتنسيق غير مدعوم
Non-zero	أُضيفت الصورة بنجاح. يُرجع معرّف ImageID الذي يمكن تمريره إلى دوال مثل SelectImage وDrawImage