AddModernImageFromFile

Processamento de imagens, codecs de imagem modernos

Descrição

Adiciona a imagem principal de um ficheiro AVIF, HEIF, HEIC ou JPEG XL através do descodificador em processo configurado

O descodificador aplica a orientação codificada e transfere as amostras descodificadas através de uma ponte PNG, para que alfa, perfis de cor ICC e até 16 bits por componente cheguem ao caminho da imagem PDF

Sintaxe

Function TPDFlib.AddModernImageFromFile(
  Const FileName: WideString;
  Options: Integer= 8): Integer;

Parâmetros

FileNameCaminho para um ficheiro AVIF, HEIF, HEIC ou JPEG XL
OptionsModo de importação compatível com PNG, em que a predefinição 8 conserva dados de imagem, alfa, ICC e amostras com elevada profundidade de bits

Valores devolvidos

Devolve o novo ImageID, ou 0 quando o ficheiro, formato, descodificador ou imagem descodificada é inválido

Observações

São aceites codificações de origem com e sem perdas, enquanto os contentores animados ou com várias imagens importam a respetiva imagem principal

Chame SetModernImageCodecLibrary antes da primeira verificação de disponibilidade ou descodificação quando a biblioteca de codecs não estiver no caminho de pesquisa predefinido

Uma imagem de 16 bits preservada eleva automaticamente um documento não bloqueado para PDF 1.5 através da verificação normal de compatibilidade

Consulte também

AddModernImageFromStream, AddModernImageFromString, ModernImageCodecAvailable