LoadImage()

Syntaxe

Resultat = LoadImage(#Image, Fichier$ [, Options])
Description
Charge une image contenue dans fichier.

Arguments

#Image Le numéro d'identification de l'image à charger.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
Fichier$ Le chemin et le nom du fichier à charger.

Si le nom de fichier ne contient pas de chemin complet, le chemin est relatif. Voir répertoire courant.
Options (optionnel) Ce paramètre n'a pour l'instant pas d'utilité. S'il est spécifié, 0 doit être utilisé pour assurer une future compatibilité.

Valeur de retour

Renvoie une valeur non nulle si l'image a été chargée avec succès et zéro sinon. Si #PB_Any a été spécifié comme paramètre #Image alors le numéro généré automatiquement est renvoyé dans 'Resultat' en cas de succès.

Remarques

La taille maximale de l'image est fonction du système d'exploitation et de la quantité de mémoire disponible. Si la mémoire disponible est suffisante alors une image de 8192x8192 peut être traitée par tous les systèmes d'exploitation pris en charge par PureBasic.

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) soit en 32 bits (si l'image a un canal alpha).

Une image chargée peut être libérée en utilisant la fonction FreeImage().

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.

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.
StartVectorDrawing() avec ImageVectorOutput() pour faire du dessin vectoriel 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.

Exemple

  If OpenWindow(0, 0, 0, 128, 128, "FreeImage", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    
    LoadImage(0, #PB_Compiler_Home + "Examples\Sources\Data\GeeBee2.bmp") ; Charge l'image depuis un fichier
    ImageGadget(0, 0, 0, 128, 128, ImageID(0)) ; Affichage
    
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

CreateImage(), CatchImage(), CopyImage(), GrabImage(), ImagePlugin library

OS Supportés

Tous

<- IsImage() - Image Index - RemoveImageFrame() ->