LoadImage()

Syntaxe

Resultat = LoadImage(#Image, FichierImage$ [, Options])

Charge l'image contenue dans FichierImage$. Si #PB_Any est utilisé pour le paramètre '#Image', le numéro de la nouvelle image sera renvoyé dans 'Resultat'. L'image peut être au format BMP, icône (.ico, seulement supporté sous Windows) ou dans un des formats supportés par la bibliothèque ImagePlugin. Quand une image est chargée, elle est convertie soit en 24 bits (si la profondeur de l'image est inférieure ou égale à 24 bits) ou en 32 bits (si l'image a un canal alpha). Si la fonction renvoie zéro, le chargement a échoué.

Par défaut, le format de l'image sera 24 bits (ou 32 bits si le fichier supporte l'alpha-channel, comme le PNG et le TIFF).

Le paramètre facultatif 'Options' n'a plus d'utilité.

Les commandes suivantes peuvent être utilisées pour activer automatiquement davantage de formats d'images:

UseJPEGImageDecoder()
UseJPEG2000ImageDecoder()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Avec l'image chargée, vous pouvez notamment utiliser les commandes suivantes :
StartDrawing() avec ImageOutput() pour dessiner dans l'image.
CopyImage() pour créer une copie de l'image.
GrabImage() pour créer une autre image en copiant une zone définie dans l'image.
DrawImage() avec ImageID() pour dessiner l'image sur la surface de dessin en cours.
DrawAlphaImage() avec ImageID() pour dessiner l'image. (avec ses composantes alpha) sur la surface de dessin en cours.
ImageGadget() pour afficher l'image dans une application fenêtrée.
ButtonImageGadget() pour créer un bouton avec image dans une application fenêtrée.

Note : La taille des images est actuellement limitée à 8192x8192 pixels (si la mémoire disponible le permet). Sous Windows, si le format de l'image est une icône (.ico), les commandes suivantes ne seront pas disponibles pour la manipuler: SaveImage() et @fastimage"ImageOutput()".

OS Supportés

Tous