SetModernImageCodecLibrary
Manejo de imágenes, configuración, códecs nativos
Descripción
Establece el archivo o directorio de la biblioteca nativa MagickWand usado por la decodificación moderna de imágenes
Sintaxis
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parámetros
| FileNameOrDirectory | Una ruta completa de biblioteca nativa o un directorio que contiene la biblioteca y sus dependencias |
|---|
Valores devueltos
| 1 | La ruta se aceptó antes de que se cargara el módulo de códec |
|---|---|
| 0 | Ya hay un módulo de códec cargado y su ruta es inmutable durante la vida del proceso |
Observaciones
Configure la ruta antes de llamar a ModernImageCodecAvailable o de importar una imagen moderna, porque cualquiera de las operaciones puede cargar el módulo
Si el argumento es un directorio de biblioteca portátil que contiene modules\coders, el cargador proporciona para ese proceso valores de MAGICK_HOME, MAGICK_CONFIGURE_PATH y MAGICK_CODER_MODULE_PATH que de otro modo no estarían definidos
Cuando no se establece una ruta explícita, el cargador comprueba PDFLIB_MODERN_IMAGE_CODEC, el directorio del ejecutable y los nombres de biblioteca de la plataforma
Las aplicaciones pueden llamar en su lugar a RegisterModernImageDecoderBackend desde PDFlibModernImage con una devolución de llamada de decodificador que devuelva un flujo PNG completamente orientado
Funciones de la unidad PDFlibModernImage
La unidad PDFlibModernImage expone la infraestructura de códecs detrás de los métodos anteriores como funciones independientes, para las aplicaciones que manejan el decodificador directamente:
DetermineModernImageFormat | Analiza un encabezado de flujo e informa mifAVIF, mifHEIF, mifJPEGXL o mifUnknown |
|---|---|
ModernImageFormatName | Devuelve el nombre del formato legible (AVIF, HEIF, JPEG XL o Unknown) |
SetModernImageCodecLibraryPath | Gemelo a nivel de unidad de este método; devuelve False una vez que el módulo de códec ya se ha cargado para el proceso |
RegisterModernImageDecoderBackend | Instala un TPDFlibModernImageDecodeCallback que recibe el flujo de entrada, el formato y un indicador ApplyOrientation y debe escribir un flujo PNG completamente orientado; tiene prioridad sobre el módulo de códec nativo |
ClearModernImageDecoderBackend | Elimina un callback registrado (equivale a registrar nil) |
ModernImageCodecAvailable | Intenta la carga única del módulo de códec e informa si la decodificación nativa es utilizable; el método TPDFlib homónimo encapsula esta comprobación |
DecodeModernImageToPNG | Decodifica una imagen a través del callback registrado o, si no lo hay, a través del módulo de códec nativo; ApplyOrientation es True de forma predeterminada |