AddImageFromString

Manejo de imágenes

Descripción

Agrega una imagen desde la memoria 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 la 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, AddImageFromString 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.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 usarán los 8 bits inferiores de cada carácter
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/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)

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 usarán los 8 bits inferiores de cada carácter

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/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

0	Los datos de imagen no eran válidos o la imagen tenía un formato no compatible. La imagen se agregó correctamente. El valor devuelto es ImageID, que puede usarse con funciones como SelectImage y DrawImage
1