AddImageFromFileOffsetA
Processamento de imagens
Descrição
O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddImageFromFileOffset e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode
Adiciona uma imagem duma parte dum ficheiro ao documento selecionado
Por exemplo, se tiverem sido concatenadas várias imagens num só ficheiro, esta função permite extrair as imagens individuais e adicioná-las ao documento
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
Os tipos de ficheiro de imagem suportados são: BMP, TIFF, JPEG, PNG, GIF, WMF e EMF
Comportamento da versão PDF: a importação de dados de imagem com 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, AddImageFromFileOffset 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 DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;DLL
int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);Parâmetros
| FileName | O nome do ficheiro que contém as imagens |
|---|---|
| Offset | O desvio no ficheiro onde começa a imagem necessária. O primeiro byte do ficheiro tem um desvio de 0 |
| DataLength | O comprimento dos dados da imagem em bytes |
| 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 ler a imagem do ficheiro. Isto pode indicar dados de imagem inválidos ou que não foi possível localizar o ficheiro |
|---|---|
| Non-zero | A imagem foi lida do ficheiro e adicionada ao documento com êxito. O valor devolvido é o ID da imagem, que pode ser utilizado com as funções de desenho de imagens, como DrawImage |