AddImageFromFileOffset

Manejo de imágenes

Descripción

Agrega una imagen desde una parte de un archivo al documento seleccionado

Por ejemplo, si muchas imágenes se concatenaron en un archivo, esta función permitirá extraer las imágenes individuales y agregarlas al documento

Una vez agregada 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

Comportamiento de versión PDF: importar datos de imagen de 16 bits por componente requiere PDF 1.5 Cuando un documento está configurado como PDF 1.4 o inferior y la versión de guardado no está bloqueada, AddImageFromFileOffset eleva automáticamente el documento a PDF 1.5 y registra 16-bit image samples en AutoBumpedFeatures Si quien llama bloquea una versión inferior para guardar, la puerta de compatibilidad rechaza el guardado con LastErrorCode 602

Para imágenes BMP y TIFF, se puede llamar a la función CompressImages antes de llamar a 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	El desplazamiento dentro del archivo donde comienza la imagen requerida. 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 normalmente 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 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 que las imágenes TIFF, EMF y WMF se carguen mediante la biblioteca gráfica GDI+. Las imágenes TIFF de varias páginas también pueden cargarse mediante GDI+ al establecer 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 puede indicar datos de imagen no válidos o que no se encontró el archivo
Non-zero	La imagen se leyó del archivo y se agregó correctamente al documento. El valor devuelto es el ID de la imagen, que se puede usar con funciones de dibujo de imágenes como DrawImage