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 با حفظ عمق بیتی بالا برای سایر انواع تصویر این پارامتر باید صفر تنظیم شود. تنظیم Options روی -1 تصاویر TIFF، EMF و WMF را وادار می‌کند با کتابخانهٔ گرافیکی GDI+ بارگذاری شوند. تصاویر TIFF چندصفحه‌ای را می‌توان با تنظیم پارامتر Options روی -PageNumber (مثلاً -3 برای صفحهٔ 3) نیز با GDI+ بارگذاری کرد |
مقادیر بازگشتی
| 0 | هنگام خواندن داده image معتبر از stream خطایی رخ داد تصویر با موفقیت به سند اضافه شد. مقدار برگردانده‌شده ID تصویر است که می‌توان آن را با توابع ترسیم image مانند DrawImage به کار برد |
|---|---|
| Non-zero |