AddImageFromString

معالجة الصور

الوصف

يضيف صورة من الذاكرة إلى المستند المحدد

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

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

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

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

الصيغة

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

المعاملات

Sourceسلسلة تحتوي المستند المطلوب توقيعه
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كانت بيانات الصورة غير صالحة أو كانت الصورة بتنسيق غير مدعوم أُضيفت الصورة بنجاح. القيمة المُرجعة هي ImageID التي يمكن استخدامها مع دوال مثل SelectImage وDrawImage
1