AddImageFromStream

Processamento de imagens

Descrição

Adiciona uma imagem de um TStream 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 de 16 bits por componente requer 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, AddImageFromStream 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 verificação 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parâmetros

InStream	O objeto TStream que contém os dados de imagem. A posição atual no fluxo será ignorada; os dados de imagem serão lidos a partir da posição 0
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).

InStream

O objeto TStream que contém os dados de imagem. A posição atual no fluxo será ignorada; os dados de imagem serão lidos a partir da posição 0

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	Ocorreu um erro ao ler dados de imagem válidos do fluxo A imagem foi adicionada com êxito ao documento. O valor devolvido é o ID da imagem, que pode ser utilizado com funções de desenho de imagens como DrawImage
Non-zero