SetModernImageCodecLibrary
Gestione delle immagini, configurazione, codec nativi
Descrizione
Imposta il file o la directory della libreria nativa MagickWand usata dalla decodifica moderna delle immagini
Sintassi
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parametri
| FileNameOrDirectory | Percorso completo di una libreria nativa oppure directory contenente la libreria e le relative dipendenze |
|---|
Valori restituiti
| 1 | Il percorso è stato accettato prima del caricamento del modulo codec |
|---|---|
| 0 | Un modulo codec è già caricato e il relativo percorso è immutabile per la durata del processo |
Note
Configurare il percorso prima di ModernImageCodecAvailable o dell'importazione moderna, poiché entrambe possono caricare il modulo
Se l'argomento è una directory di libreria portabile contenente modules\coders, il caricatore fornisce i valori MAGICK_HOME, MAGICK_CONFIGURE_PATH e MAGICK_CODER_MODULE_PATH al processo se non sono già impostati
Senza un percorso esplicito, il loader controlla PDFLIB_MODERN_IMAGE_CODEC, la directory dell'eseguibile e i nomi delle librerie di piattaforma
Le applicazioni possono chiamare RegisterModernImageDecoderBackend da PDFlibModernImage con callback che restituisce uno stream PNG orientato
Funzioni dell'unità PDFlibModernImage
L'unità PDFlibModernImage espone il meccanismo dei codec usato dai metodi sopra come funzioni autonome, per le applicazioni che azionano direttamente il decoder:
DetermineModernImageFormat | Analizza l'header di uno stream e riporta mifAVIF, mifHEIF, mifJPEGXL o mifUnknown |
|---|---|
ModernImageFormatName | Restituisce il nome del formato leggibile (AVIF, HEIF, JPEG XL o Unknown) |
SetModernImageCodecLibraryPath | Gemello a livello di unità di questo metodo; restituisce False una volta che il modulo codec è già stato caricato per il processo |
RegisterModernImageDecoderBackend | Installa un TPDFlibModernImageDecodeCallback che riceve lo stream di input, il formato e un flag ApplyOrientation e deve scrivere uno stream PNG completamente orientato; ha la precedenza sul modulo codec nativo |
ClearModernImageDecoderBackend | Rimuove un callback registrato (equivalente a registrare nil) |
ModernImageCodecAvailable | Tenta il caricamento una tantum del modulo codec e segnala se la decodifica nativa è utilizzabile; il metodo TPDFlib omonimo incapsula questa verifica |
DecodeModernImageToPNG | Decodifica un'immagine attraverso il callback registrato o, in assenza, attraverso il modulo codec nativo; ApplyOrientation è True per impostazione predefinita |