FitImageAndRelease

Tratamiento de imágenes, diseño de página, optimización

Descripción

Ajusta la imagen a un rectángulo, conserva su proporción, aplica alineación y giro y libera después el identificador de la caché

Utilice este auxiliar cuando un generador por lotes añada muchas imágenes de un solo uso que no deban seguir seleccionables tras su colocación

Sintaxis

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	El identificador de imagen devuelto por una función de creación o importación de imágenes
Left	La coordenada horizontal del rectángulo de destino
Top	La coordenada vertical del rectángulo de destino
Width	La anchura del rectángulo de destino
Height	La altura del rectángulo de destino
HAlign	Alineación horizontal dentro del rectángulo, donde 0 corresponde a la izquierda, 1 al centro y 2 a la derecha
VAlign	Alineación vertical dentro del rectángulo, donde 0 es arriba, 1 es centro y 2 es abajo
Rotate	Modo de rotación, donde 0 es normal, 1 son 90 grados en sentido antihorario, 2 son 90 grados en sentido horario y 3 son 180 grados

Valores devueltos

0	El identificador de imagen no era válido, una opción de colocación estaba fuera del intervalo, no se pudo dibujar la imagen o no se pudo liberar el identificador
1	La imagen se ajustó y el identificador se liberó

Observaciones

El PDF guardado conserva el objeto de imagen porque el diccionario de recursos de la página ya lo referencia antes de liberar el identificador de la caché

Después de que esta función se ejecute correctamente, SelectImage(ImageID) devuelve 0 para ese identificador liberado