AddImageFromString
مدیریت تصویر
توضیحات
تصویری از حافظه به سند انتخاب‌شده اضافه می‌کند
پس از افزودن تصویر به سند، می‌توان آن را چندین بار روی هر صفحه‌ای رسم کرد بدون آنکه حجم فایل 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 یا پایین‌تر تنظیم شده باشد و نسخه ذخیره قفل نشده باشد، 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 | رشته‌ای شامل دادهٔ تصویر؛ در نسخهٔ ActiveX کتابخانه این رشته باید نویسه‌های 16 بیتی داشته باشد و از هر نویسه فقط 8 بیت پایین استفاده می‌شود |
|---|---|
| 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 | دادهٔ تصویر نامعتبر بود یا تصویر در قالبی پشتیبانی‌نشده بود تصویر با موفقیت اضافه شد؛ مقدار بازگردانده‌شده ImageID است که با توابعی مانند SelectImage و DrawImage قابل استفاده است |
|---|---|
| 1 |