SetModernImageCodecLibrary
Tratamento de imagens, configuração, codecs nativos
Descrição
Define o ficheiro ou diretório da biblioteca MagickWand nativa utilizado pela descodificação moderna de imagens
Sintaxe
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parâmetros
| FileNameOrDirectory | Um caminho completo da biblioteca nativa ou um diretório que contenha a biblioteca e as respetivas dependências |
|---|
Valores devolvidos
| 1 | O caminho foi aceite antes de carregar o módulo de codecs |
|---|---|
| 0 | Já está carregado um módulo de codec e o respetivo caminho é imutável durante o tempo de vida do processo |
Observações
Configure o caminho antes de chamar ModernImageCodecAvailable ou importar uma imagem moderna, pois qualquer uma das operações pode carregar o módulo
Se o argumento for um diretório de biblioteca portátil que contenha modules\coders, o carregador fornece valores MAGICK_HOME, MAGICK_CONFIGURE_PATH e MAGICK_CODER_MODULE_PATH que ainda não estejam definidos para esse processo
Quando não é definido qualquer caminho explícito, o carregador verifica PDFLIB_MODERN_IMAGE_CODEC, o diretório do executável e os nomes de bibliotecas da plataforma
Em alternativa, as aplicações podem chamar RegisterModernImageDecoderBackend de PDFlibModernImage com uma chamada de retorno do descodificador que devolva um fluxo PNG totalmente orientado
Funções da unidade PDFlibModernImage
A unidade PDFlibModernImage expõe a maquinaria de codecs subjacente aos métodos acima como funções autónomas, para aplicações que comandam diretamente o descodificador:
DetermineModernImageFormat | Analisa um cabeçalho de fluxo e comunica mifAVIF, mifHEIF, mifJPEGXL ou mifUnknown |
|---|---|
ModernImageFormatName | Devolve o nome do formato legível (AVIF, HEIF, JPEG XL ou Unknown) |
SetModernImageCodecLibraryPath | Gémeo ao nível da unidade deste método; devolve False logo que o módulo de codec já tiver sido carregado para o processo |
RegisterModernImageDecoderBackend | Instala um TPDFlibModernImageDecodeCallback que recebe o fluxo de entrada, o formato e um sinalizador ApplyOrientation e tem de escrever um fluxo PNG totalmente orientado; tem precedência sobre o módulo de codec nativo |
ClearModernImageDecoderBackend | Remove um callback registado (equivalente a registar nil) |
ModernImageCodecAvailable | Tenta o carregamento único do módulo de codec e comunica se a descodificação nativa é utilizável; o método TPDFlib homónimo encapsula esta verificação |
DecodeModernImageToPNG | Descodifica uma imagem através do callback registado ou, na falta deste, através do módulo de codec nativo; ApplyOrientation é True por predefinição |