SetModernImageCodecLibrary

Image handling, Configuration, Native codecs

Description

Nastaví súbor alebo adresár natívnej knižnice MagickWand používaný moderným dekódovaním obrázkov

Syntax

Function TPDFlib.SetModernImageCodecLibrary(
  Const FileNameOrDirectory: WideString): Integer;

Parameters

FileNameOrDirectory	A full native library path or a directory containing the library and its dependencies

Return values

1	The path was accepted before the codec module was loaded
0	A codec module is already loaded and its path is immutable for the process lifetime

Remarks

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, the executable directory, and platform library names

Applications may instead call RegisterModernImageDecoderBackend from PDFlibModernImage with a decoder callback that returns a fully oriented PNG stream

Funkcie jednotky PDFlibModernImage

Jednotka PDFlibModernImage sprístupňuje kodekovú mechaniku za vyššie uvedenými metódami ako samostatné funkcie pre aplikácie, ktoré riadia dekóder priamo:

`DetermineModernImageFormat`	Preskúma hlavičku prúdu a hlási `mifAVIF`, `mifHEIF`, `mifJPEGXL` alebo `mifUnknown`
`ModernImageFormatName`	Vracia ľudsky čitateľný názov formátu (`AVIF`, `HEIF`, `JPEG XL` alebo `Unknown`)
`SetModernImageCodecLibraryPath`	Ekvivalent tejto metody na úrovni jednotky; vracia `False`, keď bol modul kodeku pre proces už načítaný
`RegisterModernImageDecoderBackend`	Inštaluje `TPDFlibModernImageDecodeCallback`, ktorý prijíma vstupný prúd, formát a príznak `ApplyOrientation` a musí zapísať plne orientovaný prúd PNG; má prednosť pred natívnym modulom kodeku
`ClearModernImageDecoderBackend`	Odstráni zaregistrovaný callback (ekvivalent registrácie `nil`)
`ModernImageCodecAvailable`	Skúsi jednorazové načítanie modulu kodeku a hlási, či je natívne dekódovanie použiteľné; rovnako pomenovaná `TPDFlib` túto kontrolu obaľuje
`DecodeModernImageToPNG`	Dekóduje jeden obraz cez zaregistrovaný callback, alebo bez neho cez natívny modul kodeku; `ApplyOrientation` má predvolenú hodnotu `True`