FitImageAndRelease

Manipulação de imagens, Layout da página, Otimização

Descrição

Ajusta a imagem especificada dentro de um retângulo de destino, preserva a proporção da imagem, aplica o alinhamento e a rotação solicitados e depois libera esse handle de imagem do cache de imagens do documento

Use este helper quando um gerador em lote adiciona muitas imagens de uso único que não devem continuar selecionáveis após o posicionamento

Sintaxe

Delphi

Function TPDFlib.FitImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double; HAlign, VAlign, Rotate: Integer): Integer;

ActiveX

Function PDFlib::FitImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double, HAlign As Long, VAlign As Long, Rotate As Long) As Long

DLL

int DLFitImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height, int HAlign, int VAlign, int Rotate);

Parâmetros

ImageID	O handle de imagem retornado por uma função de criação ou importação de imagens
Left	A coordenada horizontal do retângulo alvo
Top	A coordenada vertical do retângulo alvo
Width	The target rectangle width
Height	The target rectangle height
HAlign	Alinhamento horizontal dentro do retângulo, em que 0 é esquerda, 1 é centro e 2 é direita
VAlign	Alinhamento vertical dentro do retângulo, em que 0 é topo, 1 é centro e 2 é base
Rotate	Modo de rotação, em que 0 é normal, 1 é 90 graus no sentido anti-horário, 2 é 90 graus no horário e 3 é 180 graus

Valores retornados

0	O handle de imagem era inválido, uma opção de posicionamento estava fora do intervalo, a imagem não pôde ser desenhada, ou o handle não pôde ser liberado
1	A imagem foi ajustada e o handle foi liberado

Observações

O PDF salvo mantém o objeto de imagem porque o dicionário de recursos da página já faz referência a ele antes que o identificador do cache seja liberado

Depois que esta função tem sucesso, SelectImage(ImageID) retorna 0 para o handle liberado