AddImageFromFile

Traitement des images

Description

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

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 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 TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * 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 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

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