SetModernImageCodecLibrary
Zpracování obrázků, konfigurace, nativní kodeky
Popis
Nastaví soubor nebo adresář nativní knihovny MagickWand používané moderním dekódováním obrázků
Syntaxe
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parametry
| FileNameOrDirectory | Úplná cesta k nativní knihovně, nebo adresář obsahující knihovnu i její závislosti |
|---|
Návratové hodnoty
| 1 | Cesta se přijala dřív, než se načetl modul kodeku |
|---|---|
| 0 | Modul kodeku je už načtený a jeho cesta se po dobu života procesu nemění |
Poznámky
Cestu nakonfigurujte před voláním ModernImageCodecAvailable nebo před importem moderního obrázku, protože každá z těchto operací může modul načíst Je-li argumentem přenositelný adresář knihovny obsahující
modules\coders, loader dodá pro ten proces jinak nenastavené hodnoty MAGICK_HOME, MAGICK_CONFIGURE_PATH a MAGICK_CODER_MODULE_PATH Když není nastavena explicitní cesta, loader zkontroluje
PDFLIB_MODERN_IMAGE_CODEC
RegisterModernImageDecoderBackend, adresář spustitelného souboru a názvy platformových knihoven Aplikace mohou místo toho volat PDFlibModernImage z
Funkce jednotky PDFlibModernImage
Jednotka PDFlibModernImage zpřístupňuje kodekovou mechaniku za výše uvedenými metodami jako samostatné funkce pro aplikace, které řídí dekodér přímo:
DetermineModernImageFormat | Zkoumá hlavičku proudu a hlásí mifAVIF, mifHEIF, mifJPEGXL nebo mifUnknown |
|---|---|
ModernImageFormatName | Vrací lidsky čitelný název formátu (AVIF, HEIF, JPEG XL nebo Unknown) |
SetModernImageCodecLibraryPath | Protějšek této metody na úrovni jednotky; vrací False, jakmile byl modul kodeku pro proces již načten |
RegisterModernImageDecoderBackend | Instaluje TPDFlibModernImageDecodeCallback, který přijímá vstupní proud, formát a příznak ApplyOrientation a musí zapsat plně orientovaný proud PNG; má přednost před nativním modulem kodeku |
ClearModernImageDecoderBackend | Odebere zaregistrovaný callback (ekvivalent registrace nil) |
ModernImageCodecAvailable | Pokusí se o jednorázové načtení modulu kodeku a hlásí, zda je nativní dekódování použitelné; stejně pojmenovaná TPDFlib tuto kontrolu obaluje |
DecodeModernImageToPNG | Dekóduje jeden obraz přes zaregistrovaný callback, nebo bez něj přes nativní modul kodeku; ApplyOrientation má výchozí hodnotu True |