SetModernImageCodecLibrary
Image handling, Configuration, Native codecs
Опис
Задає нативний файл чи теку бібліотеки MagickWand, які використовує сучасне декодування зображень
Синтаксис
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Параметри
| FileNameOrDirectory | Повний нативний шлях до бібліотеки чи тека, що містить бібліотеку та її залежності |
|---|
Return values
| 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 |