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

SourceUna 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
OptionsEn 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

0Los 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