SetModernImageCodecLibrary
Tratamiento de imágenes, configuración, códecs nativos
Descripción
Establece el archivo o directorio de la biblioteca nativa MagickWand utilizado por la descodificació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 cargar 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, ya que cualquiera de las dos operaciones puede cargar el módulo
Si el argumento es un directorio portátil con modules\coders, el cargador proporciona valores MAGICK_HOME, MAGICK_CONFIGURE_PATH y MAGICK_CODER_MODULE_PATH no establecidos
Cuando no se establece ninguna ruta explícita, el cargador comprueba PDFLIB_MODERN_IMAGE_CODEC, el directorio del ejecutable y los nombres de bibliotecas de la plataforma
Como alternativa, las aplicaciones pueden llamar a RegisterModernImageDecoderBackend desde PDFlibModernImage con una devolución de llamada de descodificación 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 una cabecera 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 |