AddImageFromFileOffset

Manejo de imágenes

Descripción

Añade una imagen desde una parte de un archivo al documento seleccionado

Por ejemplo, si se han concatenado muchas imágenes en un archivo, esta función permite extraer las imágenes individuales y añadirlas al documento

Una vez añadida una imagen al documento, se puede dibujar varias veces en cualquier página sin aumentar más el tamaño del archivo PDF

Los tipos de archivo de imagen compatibles son: BMP, TIFF, JPEG, PNG, GIF, WMF y EMF

Importar imagen de 16 bits requiere PDF 1.5. AddImageFromFileOffset eleva automáticamente y registra 16-bit image samples en AutoBumpedFeatures; una versión inferior bloqueada falla con LastErrorCode 602

Para las imágenes BMP y TIFF, se puede llamar a la función CompressImages antes de esta función para comprimir los datos de imagen. Los demás tipos de imagen se comprimen automáticamente

Sintaxis

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	El nombre del archivo que contiene las imágenes
Offset	Desplazamiento dentro del archivo donde comienza la imagen necesaria. El primer byte del archivo tiene un desplazamiento de 0
DataLength	La longitud de los datos de imagen en bytes
Options	Para imágenes TIFF de varias páginas, este parámetro especifica el número de página que se cargará. Para imágenes PNG: 0 = Cargar la imagen de la forma habitual 1 = Cargar el canal alfa como imagen en escala de grises 2 = Cargar la imagen y el canal alfa (limitar alfa a 8 bits) 3 = Cargar la imagen (limitar la imagen a 8 bits por canal) 4 = Cargar el canal alfa (limitar a 8 bits por canal) 5 = Cargar la imagen con el canal alfa (limitar ambos a 8 bits por canal) 6 = Cargar la imagen y el canal alfa 7 = Cargar la imagen y el perfil de color ICC Para otros tipos de imagen, este parámetro debe establecerse en 0. Establecer Options en -1 fuerza la carga de las imágenes TIFF, EMF y WMF mediante la biblioteca gráfica GDI+. Las imágenes TIFF de varias páginas también pueden cargarse con GDI+ estableciendo el parámetro Options en -PageNumber (por ejemplo, -3 para la página 3)

Valores devueltos

0	No se pudo leer la imagen del archivo. Esto podría indicar que los datos de imagen no son válidos o que no se encontró el archivo
Non-zero	La imagen se leyó del archivo y se añadió correctamente. El valor devuelto es su ID, utilizable con funciones de dibujo como DrawImage