AddImageFromFile
Manejo de imágenes
Descripción
Añade una imagen desde un archivo al documento seleccionado
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 imagen admitidos son BMP, TIFF, JPEG, PNG, GIF, WMF, EMF y WebP, además de AVIF, HEIF, HEIC y JPEG XL si existe un descodificador moderno
Importar imagen de 16 bits requiere PDF 1.5. AddImageFromFile 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.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;ActiveX
Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As LongDLL
int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);Parámetros
| FileName | Nombre del archivo de imagen que se añadirá |
|---|---|
| Options | En TIFF multipágina indica página. En PNG: 0 normal 1 alfa como gris 2 imagen + alfa a 8 bits 3 imagen a 8 bits 4 alfa a 8 bits 5 ambos a 8 bits 6 imagen + alfa 7 imagen + ICC 8 imagen + alfa + ICC con alta profundidad. Otros: 0. -1 fuerza GDI+ para TIFF/EMF/WMF; -PageNumber carga esa página TIFF con GDI+ |
Valores devueltos
| 0 | No se pudo añadir la imagen. No se encontró o tiene un formato no compatible |
|---|---|
| Non-zero | La imagen se ha añadido correctamente. Se devuelve ImageID, que puede pasarse a funciones como SelectImage y DrawImage |