AddImageFromFileOffset

Manipulação de imagens

Descrição

Adiciona uma imagem de uma parte de um arquivo ao documento selecionado

Por exemplo, se muitas imagens foram concatenadas em um único arquivo, esta função permite que as imagens individuais sejam extraídas e adicionadas ao documento

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 e EMF

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, AddImageFromFileOffset 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Parâmetros

FileName	O nome do arquivo que contém as imagens.
Offset	O offset no arquivo onde começa a imagem desejada. O primeiro byte do arquivo tem offset 0.
DataLength	O comprimento dos dados da imagem em bytes
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 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 lida do arquivo. Isso pode indicar dados de imagem inválidos ou que o arquivo não foi encontrado.
Non-zero	A imagem foi lida do arquivo e adicionada ao documento com sucesso. O valor retornado é o ID da imagem, que pode ser usado com as funções de desenho de imagens como DrawImage.