AddImageFromString

Traitement des images

Description

Ajoute une image depuis la mémoire au document sélectionné

Une image ajoutée au document peut être dessinée plusieurs fois sur n'importe quelle page sans augmenter davantage la taille du fichier PDF

Les types d'image pris en charge sont BMP, TIFF, JPEG, PNG, GIF, WMF, EMF et WebP, plus AVIF, HEIF, HEIC et JPEG XL si un décodeur moderne est disponible

Comportement de version PDF : l’importation d’images 16 bits par composante exige PDF 1.5. Avec PDF 1.4 ou inférieur non verrouillé, AddImageFromString relève automatiquement la version à PDF 1.5 et consigne 16-bit image samples dans AutoBumpedFeatures. Une version inférieure verrouillée est refusée avec LastErrorCode 602

Pour les images BMP et TIFF, CompressImages peut être appelée avant cette fonction pour compresser les données. Les autres types sont automatiquement compressés

Syntaxe

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Paramètres

Source	Chaîne contenant les données d'image. Dans la version ActiveX, elle doit contenir des caractères 16 bits ; seuls les 8 bits inférieurs sont utilisés
Options	Pour une image TIFF multipage, ce paramètre indique la page à charger. Pour PNG : 0 = Charger normalement 1 = Charger le canal alpha comme image en niveaux de gris 2 = Charger image et alpha (alpha limité à 8 bits) 3 = Charger l’image (limitée à 8 bits/canal) 4 = Charger l’alpha (limité à 8 bits/canal) 5 = Charger image et alpha (tous deux limités à 8 bits/canal) 6 = Charger image et alpha 7 = Charger l’image et le profil ICC 8 = Charger l’image, l’alpha et le profil ICC en conservant la profondeur élevée Pour les autres types, utilisez 0. Options = -1 force le chargement TIFF, EMF et WMF avec GDI+. Un TIFF multipage peut aussi employer GDI+ avec Options = -PageNumber, par exemple -3 pour la page 3

Source

Chaîne contenant les données d'image. Dans la version ActiveX, elle doit contenir des caractères 16 bits ; seuls les 8 bits inférieurs sont utilisés

Options

Pour une image TIFF multipage, ce paramètre indique la page à charger. Pour PNG : 0 = Charger normalement 1 = Charger le canal alpha comme image en niveaux de gris 2 = Charger image et alpha (alpha limité à 8 bits) 3 = Charger l’image (limitée à 8 bits/canal) 4 = Charger l’alpha (limité à 8 bits/canal) 5 = Charger image et alpha (tous deux limités à 8 bits/canal) 6 = Charger image et alpha 7 = Charger l’image et le profil ICC 8 = Charger l’image, l’alpha et le profil ICC en conservant la profondeur élevée Pour les autres types, utilisez 0. Options = -1 force le chargement TIFF, EMF et WMF avec GDI+. Un TIFF multipage peut aussi employer GDI+ avec Options = -PageNumber, par exemple -3 pour la page 3

Valeurs de retour

0	Données d'image non valides ou format non pris en charge Image ajoutée avec succès. La valeur renvoyée est ImageID, utilisable avec SelectImage et DrawImage
1