SetModernImageCodecLibrary
Обработка изображений, конфигурация, собственные кодеки
Описание
Задаёт файл или каталог нативной библиотеки MagickWand для современного декодирования изображений
Синтаксис
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Параметры
| FileNameOrDirectory | Полный путь к нативной библиотеке либо каталог с ней и её зависимостями |
|---|
Возвращаемые значения
| 1 | Путь принят до загрузки модуля кодека |
|---|---|
| 0 | Модуль кодека уже загружен, и его путь неизменяем на всё время жизни процесса |
Примечания
Configure the path before calling ModernImageCodecAvailable or importing a modern image because either operation may load the module If the argument is a portable library directory containing
modules\coders, the loader supplies otherwise-unset MAGICK_HOME, MAGICK_CONFIGURE_PATH, and MAGICK_CODER_MODULE_PATH values for that process
When no explicit path is set, the loader checks
PDFLIB_MODERN_IMAGE_CODEC
RegisterModernImageDecoderBackend, the executable directory, and platform library names
Applications may instead call PDFlibModernImage from
Функции модуля 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 |