AddImageFromFileOffset

Traitement des images

Description

Ajoute une image depuis une partie d’un fichier au document sélectionné

Par exemple, si plusieurs images ont été concaténées dans un fichier, cette fonction permet d'extraire les images individuelles et de les ajouter au document

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 de version PDF : l’importation d’images 16 bits par composante exige PDF 1.5. Avec une version inférieure non verrouillée, AddImageFromFileOffset relève automatiquement le document à 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.AddImageFromFileOffset(Const FileName: WideString; Offset, DataLength, Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFileOffset(FileName As String, Offset As Long, DataLength As Long, Options As Long) As Long

DLL

int DLAddImageFromFileOffset(int InstanceID, const wchar_t * FileName, int Offset, int DataLength, int Options);

Paramètres

FileName	Nom du fichier contenant les images
Offset	Le décalage dans le fichier où commence l'image requise Le premier octet du fichier possède un décalage de 0
DataLength	Longueur des données de l’image en octets
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 lue dans le fichier Les données d'image sont peut-être non valides ou le fichier est introuvable
Non-zero	L'image a été lue depuis le fichier et ajoutée au document. La valeur renvoyée est son ID, utilisable avec des fonctions de dessin telles que DrawImage