SetModernImageCodecLibrary
پردازش تصویر، پیکربندی، codecهای بومی
توضیحات
فایل یا پوشهٔ کتابخانهٔ بومی MagickWand مورد استفاده در رمزگشایی تصویر مدرن را تنظیم میکند
نحو
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;پارامترها
| FileNameOrDirectory | مسیر کامل کتابخانهٔ بومی یا پوشهای شامل کتابخانه و وابستگیهای آن |
|---|
مقادیر بازگشتی
| 1 | مسیر پیش از بارگذاری ماژول کدک پذیرفته شد |
|---|---|
| 0 | یک ماژول کدک از قبل بارگذاری شده و مسیرش برای عمر فرایند تغییرناپذیر است |
ملاحظات
مسیر را قبل از فراخوانی ModernImageCodecAvailable یا ورود تصویر مدرن پیکربندی کنید چون هر یک از این دو ممکن است ماژول را بارگذاری کند اگر آرگومان پوشهٔ کتابخانهٔ قابلحمل حاوی باشد
modules\coders، لودر مقادیر MAGICK_HOME، MAGICK_CONFIGURE_PATH و MAGICK_CODER_MODULE_PATH را که در غیر این صورت تنظیم نمیشدند برای آن فرایند تأمین میکند وقتی مسیر صریحی تنظیم نشده باشد لودر بررسی میکند
PDFLIB_MODERN_IMAGE_CODEC
RegisterModernImageDecoderBackend، پوشهٔ فایل اجرایی و نامهای کتابخانهٔ سکو برنامهها میتوانند بهجای آن PDFlibModernImage را از فراخوانی کنند
توابع واحد PDFlibModernImage
واحد PDFlibModernImage زیرساخت کُدک پشت متدهای بالا را برای برنامههایی که رمزگشا را مستقیم میرانند بهصورت توابع مستقل در دسترس میگذارد:
DetermineModernImageFormat | سرآیند جریان را میباید و mifAVIF، mifHEIF، mifJPEGXL یا mifUnknown را گزارش میکند |
|---|---|
ModernImageFormatName | نام قالب خوانا برای انسان را برمیگرداند (AVIF، HEIF، JPEG XL یا Unknown) |
SetModernImageCodecLibraryPath | دوقلوی این متد در سطح واحد؛ بهمحض اینکه ماژول کُدک برای فرایند قبلاً بارگذاری شده باشد False برمیگرداند |
RegisterModernImageDecoderBackend | یک TPDFlibModernImageDecodeCallback نصب میکند که جریان ورودی، قالب و پرچم ApplyOrientation را میگیرد و باید جریان PNG کاملاً جهتیافتهای بنویسد؛ بر ماژول کُدک بومی اولویت دارد |
ClearModernImageDecoderBackend | یک callback ثبتشده را حذف میکند (معادل ثبت nil) |
ModernImageCodecAvailable | بارگذاری یکباره ماژول کُدک را امتحان میکند و گزارش میدهد که رمزگشایی بومی قابل استفاده است یا نه؛ متد TPDFlib همنام این بررسی را در بر میگیرد |
DecodeModernImageToPNG | یک تصویر را از طریق callback ثبتشده یا، در نبود آن، از طریق ماژول کُدک بومی رمزگشایی میکند؛ پیشفرض ApplyOrientation برابر True است |