AddImageFromFileOffset

معالجة الصور

الوصف

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

مثلًا إذا دُمجت صور كثيرة في ملف واحد، تتيح هذه الدالة استخراج الصور المنفردة وإضافتها إلى المستند

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

أنواع ملفات الصور المدعومة هي: BMP وTIFF وJPEG وPNG وGIF وWMF وEMF

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

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

الصيغة

Delphi

Function TPDFlib.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

المعاملات

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

قيم الإرجاع

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