AddImageFromFile

Manejo de imágenes

Descripción

Agrega una imagen desde un archivo al documento seleccionado

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 admitidos son BMP, TIFF, JPEG, PNG, GIF, WMF, EMF y WebP, además de AVIF, HEIF, HEIC y JPEG XL cuando hay disponible un decodificador de imágenes moderno

Comportamiento de versión de PDF: importar datos de imagen de 16 bits por componente requiere PDF 1.5. Cuando un documento se establece en PDF 1.4 o inferior y la versión de guardado no está bloqueada, AddImageFromFile eleva automáticamente el documento a PDF 1.5 y registra 16-bit image samples en AutoBumpedFeatures. Si quien llama bloquea una versión de guardado inferior, 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.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parámetros

FileNameEl nombre de archivo de la imagen que se agregará
OptionsPara 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/canal) 4 = Cargar el canal alfa (limitar a 8 bits/canal) 5 = Cargar la imagen con canal alfa (limitar ambos a 8 bits/canal) 6 = Cargar la imagen y el canal alfa 7 = Cargar la imagen y el perfil de color ICC 8 = Cargar la imagen, el canal alfa y el perfil de color ICC conservando alta profundidad de bits Para otros tipos de imagen este parámetro debe establecerse en 0. Establecer Options en -1 obliga a cargar imágenes TIFF, EMF y WMF usando la biblioteca gráfica GDI+. Las imágenes TIFF de varias páginas también se pueden cargar mediante GDI+ estableciendo el parámetro Options en -PageNumber (por ejemplo, -3 para la página 3)

Valores devueltos

0No se pudo agregar la imagen No se pudo encontrar o está en un formato no compatible
Non-zeroLa imagen se agregó correctamente. Se devuelve el ImageID, que puede pasarse a funciones como SelectImage y DrawImage