AddImageFromStream

معالجة الصور

الوصف

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

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

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

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

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

الصيغة

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

المعاملات

InStreamكائن TStream الذي يحتوي بيانات الصورة. وسيُتجاهل الموضع الحالي في التدفق وستُقرأ بيانات الصورة من الموضع 0 في التدفق
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