AddImageFromFile

Manipulação de imagens

Descrição

Adiciona uma imagem de um arquivo ao documento selecionado

Depois que uma imagem é adicionada ao documento, ela pode ser desenhada em qualquer página várias vezes sem aumentar novamente o tamanho do arquivo PDF

Os tipos de arquivo de imagem suportados são BMP, TIFF, JPEG, PNG, GIF, WMF, EMF e WebP, além de AVIF, HEIF, HEIC e JPEG XL quando um decodificador de imagens moderno está disponível

Comportamento da versão PDF: importar dados de imagem com 16 bits por componente exige PDF 1.5 Quando um documento está definido como PDF 1.4 ou inferior e a versão de salvamento não está bloqueada, AddImageFromFile eleva automaticamente o documento para PDF 1.5 e registra 16-bit image samples em AutoBumpedFeatures Se o chamador bloquear uma versão inferior de salvamento, a verificação de compatibilidade rejeitará o salvamento com LastErrorCode 602

Para imagens BMP e TIFF, a função CompressImages pode ser chamada antes desta função para comprimir os dados da imagem. Outros tipos de imagem são comprimidos automaticamente

Sintaxe

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parâmetros

FileName	O nome do arquivo da imagem a adicionar.
Options	Para imagens TIFF de várias páginas este parâmetro especifica o número da página a carregar. Para imagens PNG: 0 = Carregar a imagem normalmente 1 = Carregar o canal alfa como uma imagem em tons de cinza 2 = Carregar a imagem e o canal alfa (limitar o alfa a 8 bits) 3 = Carregar a imagem (limitar a imagem a 8 bits/canal) 4 = Carregar o canal alfa (limitar a 8 bits/canal) 5 = Carregar a imagem com canal alfa (limitar ambos a 8 bits/canal) 6 = Carregar a imagem e o canal alfa 7 = Carregar a imagem e o perfil de cores ICC 8 = Carregar a imagem, o canal alfa e o perfil de cores ICC mantendo a profundidade de bits alta Para outros tipos de imagem este parâmetro deve ser definido como 0. Definir Options como -1 força imagens TIFF, EMF e WMF a serem carregadas pela biblioteca gráfica GDI+. Imagens TIFF de várias páginas também podem ser carregadas via GDI+ definindo o parâmetro Options como -PageNumber (por exemplo, -3 para a página 3).

FileName

O nome do arquivo da imagem a adicionar.

Options

Para imagens TIFF de várias páginas este parâmetro especifica o número da página a carregar. Para imagens PNG: 0 = Carregar a imagem normalmente 1 = Carregar o canal alfa como uma imagem em tons de cinza 2 = Carregar a imagem e o canal alfa (limitar o alfa a 8 bits) 3 = Carregar a imagem (limitar a imagem a 8 bits/canal) 4 = Carregar o canal alfa (limitar a 8 bits/canal) 5 = Carregar a imagem com canal alfa (limitar ambos a 8 bits/canal) 6 = Carregar a imagem e o canal alfa 7 = Carregar a imagem e o perfil de cores ICC 8 = Carregar a imagem, o canal alfa e o perfil de cores ICC mantendo a profundidade de bits alta Para outros tipos de imagem este parâmetro deve ser definido como 0. Definir Options como -1 força imagens TIFF, EMF e WMF a serem carregadas pela biblioteca gráfica GDI+. Imagens TIFF de várias páginas também podem ser carregadas via GDI+ definindo o parâmetro Options como -PageNumber (por exemplo, -3 para a página 3).

Valores retornados

0	A imagem não pôde ser adicionada. Ou não foi encontrada, ou está em um formato não suportado.
Non-zero	A imagem foi adicionada com sucesso. O ImageID é retornado e pode ser passado para funções como SelectImage e DrawImage.