AddImageFromVariant

مدیریت تصویر

توضیحات

تصویری از آرایهٔ بایتی variant به سند انتخاب‌شده اضافه می‌کند

پس از افزودن تصویر به سند، می‌توان آن را چندین بار روی هر صفحه‌ای رسم کرد بدون آنکه حجم فایل PDF بیشتر افزایش یابد

انواع فایل تصویری پشتیبانی‌شده عبارت‌اند از: BMP، TIFF، JPEG، PNG، GIF، WMF و EMF

برای تصاویر BMP و TIFF می‌توان پیش از فراخوانی این تابع، تابع CompressImages را برای فشرده‌سازی دادهٔ تصویر صدا زد؛ سایر انواع تصویر به‌طور خودکار فشرده می‌شوند

نحو

ActiveX

Function PDFlib::AddImageFromVariant(SourceData As Variant, Options As Long) As Long

پارامترها

SourceData

متغیری شامل دادهٔ تصویر

گزینه‌ها

برای تصاویر TIFF چندصفحه‌ای این پارامتر شمارهٔ صفحه‌ای را مشخص می‌کند که بارگذاری می‌شود

برای تصاویر PNG:

0 = تصویر به‌صورت معمول بارگذاری می‌شود

1 = بارگذاری کانال آلفا به‌عنوان تصویر خاکستری

2 = بارگذاری تصویر و کانال آلفا (محدود کردن آلفا به 8 بیت)

3 = بارگذاری تصویر (محدود کردن تصویر به 8 بیت/کانال)

4 = بارگذاری کانال آلفا (محدود به 8 بیت/کانال)

5 = تصویر را با alpha channel بارگذاری می‌کند (هر دو را به 8-bit/channel محدود می‌کند)

6 = تصویر و کانال alpha را بارگذاری کنید

7 = بارگذاری تصویر و پروفایل رنگ ICC

برای انواع دیگر تصویر این پارامتر باید 0 تنظیم شود

تنظیم Options روی -1 تصاویر TIFF، EMF و WMF را وادار می‌کند با کتابخانهٔ گرافیکی GDI+ بارگذاری شوند. تصاویر TIFF چندصفحه‌ای را می‌توان با تنظیم پارامتر Options روی -PageNumber (مثلاً -3 برای صفحهٔ 3) نیز با GDI+ بارگذاری کرد

مقادیر بازگشتی

0تصویر اضافه نشد
Non-zeroتصویر با موفقیت اضافه شد؛ این شناسهٔ تصویر جدید است