AddImageFromFileA

Traitement des images

Description

Le A final indique le point d’entrée de DLL ANSI (char); l’interface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à AddImageFromFile et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Ajoute une image depuis un fichier 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

Types de fichiers image pris en charge : BMP, TIFF, JPEG, PNG, GIF, WMF et EMF

Comportement selon la version PDF : l’importation de données d’image à 16 bits par composante requiert PDF 1.5. Lorsqu’un document est défini sur PDF 1.4 ou une version antérieure et que la version d’enregistrement n’est pas verrouillée, AddImageFromFile fait automatiquement passer le document à PDF 1.5 et enregistre 16-bit image samples dans AutoBumpedFeatures. Si l’appelant verrouille une version d’enregistrement antérieure, le contrôle de compatibilité rejette l’enregistrement 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 DLAddImageFromFileA(InstanceID: Integer; FileName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddImageFromFileA(int InstanceID, const char * FileName, int Options);

Paramètres

FileName	Nom du fichier image à ajouter
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 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

FileName

Nom du fichier image à ajouter

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 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	L'image n'a pas pu être ajoutée Elle est introuvable ou son format n'est pas pris en charge
Non-zero	L'image a été ajoutée avec succès. L'ImageID renvoyé peut être transmis à des fonctions telles que SelectImage et DrawImage