AddImageFromString

Manipulação de imagens

Descrição

Adiciona uma imagem da memória 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 de versão do PDF: importar dados de imagem com 16 bits por componente exige PDF 1.5. Quando um documento está definido como PDF 1.4 ou menor e a versão de salvamento não estiver travada, AddImageFromString eleva automaticamente o documento para PDF 1.5 e registra 16-bit image samples em AutoBumpedFeatures. Se o chamador travar uma versão de salvamento menor, o gate de compatibilidade rejeita 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Parâmetros

Source	Uma string contendo os dados da imagem. Na versão ActiveX da biblioteca essa string deve conter caracteres de 16 bits; apenas os 8 bits inferiores de cada caractere serão usados.
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).

Source

Uma string contendo os dados da imagem. Na versão ActiveX da biblioteca essa string deve conter caracteres de 16 bits; apenas os 8 bits inferiores de cada caractere serão usados.

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	Os dados da imagem eram inválidos ou a imagem estava em um formato não suportado. A imagem foi adicionada com sucesso. O valor retornado é o ImageID, que pode ser usado com funções como SelectImage e DrawImage.
1