AddImageFromFile

Processamento de imagens

Descrição

Adiciona uma imagem proveniente de um ficheiro ao documento selecionado

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

Supported image file types are: BMP, TIFF, JPEG, PNG, GIF, WMF and EMF.

Comportamento da versão PDF: a importação de 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 gravação não está bloqueada, AddImageFromFile eleva automaticamente o documento para PDF 1.5 e regista 16-bit image samples em AutoBumpedFeatures. Se o chamador bloquear uma versão de gravação inferior, a barreira de compatibilidade rejeita a gravação com LastErrorCode 602

Para imagens BMP e TIFF, a função CompressImages pode ser chamada antes desta função para comprimir os dados de 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 ficheiro da imagem a adicionar
Options	For multi-page TIFF images this parameter specifies the page number to load. For PNG images: 0 = Carregar a imagem como habitualmente 1 = Carregar o canal alfa como uma imagem em tons de cinzento 2 = Carregar a imagem e o canal alfa (limitar alfa a 8 bits) 3 = Carregar a imagem (limitar 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 cor ICC For other image types this parameter should be set to 0. Setting Options to -1 forces TIFF, EMF and WMF images to be loaded using the GDI+ graphics library. Multipage TIFF images can also be loaded using GDI+ by setting the Options parameter to -PageNumber (for example -3 for page 3).

FileName

O nome do ficheiro da imagem a adicionar

Options

For multi-page TIFF images this parameter specifies the page number to load. For PNG images: 0 = Carregar a imagem como habitualmente 1 = Carregar o canal alfa como uma imagem em tons de cinzento 2 = Carregar a imagem e o canal alfa (limitar alfa a 8 bits) 3 = Carregar a imagem (limitar 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 cor ICC For other image types this parameter should be set to 0. Setting Options to -1 forces TIFF, EMF and WMF images to be loaded using the GDI+ graphics library. Multipage TIFF images can also be loaded using GDI+ by setting the Options parameter to -PageNumber (for example -3 for page 3).

Valores devolvidos

0	Não foi possível adicionar a imagem. Não foi encontrada ou está num formato não suportado
Non-zero	A imagem foi adicionada com êxito. É devolvido o ImageID, que pode ser passado a funções como SelectImage e DrawImage