SetModernImageCodecLibrary
Traitement des images, configuration, codecs natifs
Description
Définit le fichier ou le dossier de la bibliothèque native MagickWand utilisé par le décodage d'images moderne
Syntaxe
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Paramètres
| FileNameOrDirectory | Un chemin complet de bibliothèque native ou un dossier contenant la bibliothèque et ses dépendances |
|---|
Valeurs de retour
| 1 | Le chemin a été accepté avant le chargement du module de codec |
|---|---|
| 0 | Un module de codec est déjà chargé et son chemin reste immuable pendant toute la durée de vie du processus |
Remarques
Configurez le chemin avant ModernImageCodecAvailable ou l'importation d'une image moderne, car l'une ou l'autre opération peut charger le module
Si l’argument est un répertoire de bibliothèque portable contenant modules\coders, le chargeur fournit au processus les valeurs MAGICK_HOME, MAGICK_CONFIGURE_PATH et MAGICK_CODER_MODULE_PATH qui ne sont pas déjà définies
Lorsqu'aucun chemin explicite n'est défini, le chargeur vérifie PDFLIB_MODERN_IMAGE_CODEC, le répertoire de l'exécutable et les noms de bibliothèque de la plateforme
Les applications peuvent plutôt appeler RegisterModernImageDecoderBackend depuis PDFlibModernImage avec un rappel de décodage renvoyant un flux PNG entièrement orienté
Fonctions de l’unité PDFlibModernImage
L’unité PDFlibModernImage expose la mécanique des codecs derrière les méthodes ci-dessus sous forme de fonctions autonomes, pour les applications qui pilotent directement le décodeur :
DetermineModernImageFormat | Examine l’en-tête d’un flux et signale mifAVIF, mifHEIF, mifJPEGXL ou mifUnknown |
|---|---|
ModernImageFormatName | Renvoie le nom de format lisible (AVIF, HEIF, JPEG XL ou Unknown) |
SetModernImageCodecLibraryPath | Jumeau au niveau de l’unité de cette méthode ; renvoie False dès que le module de codec a déjà été chargé pour le processus |
RegisterModernImageDecoderBackend | Installe un TPDFlibModernImageDecodeCallback qui reçoit le flux d’entrée, le format et un indicateur ApplyOrientation, et doit écrire un flux PNG entièrement orienté ; il prime sur le module de codec natif |
ClearModernImageDecoderBackend | Supprime un callback enregistré (équivalent à enregistrer nil) |
ModernImageCodecAvailable | Tente le chargement unique du module de codec et indique si le décodage natif est utilisable ; la méthode TPDFlib du même nom encapsule cette vérification |
DecodeModernImageToPNG | Décode une image via le callback enregistré ou, à défaut, via le module de codec natif ; ApplyOrientation vaut True par défaut |