AddImageFromString
Manejo de imágenes
Descripción
Añade una imagen desde la memoria 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. AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;
DLL
int DLAddImageFromString(int InstanceID, const char * Source, int Options);
Parámetros
| Source | Una cadena que contiene los datos de imagen. En la versión ActiveX de la biblioteca, esta cadena debe contener caracteres de 16 bits; solo se utilizarán los 8 bits inferiores de cada carácter |
|---|---|
| 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 | Los datos de la imagen no eran válidos o la imagen tenía un formato no compatible La imagen se añadió correctamente. El valor devuelto es el ImageID, que se puede utilizar con funciones como SelectImage y DrawImage |
|---|---|
| 1 |