LoadImage()

Syntaxe

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

Lit 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 (non compressé), icône (.ico, seulement supporté sous Windows) ou dans un des formats supportés par la bibliothèque ImagePlugin. Si la fonction renvoie 0, le chargement a échoué, sinon, tout va bien.

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' peut prendre une des valeurs suivantes:

  #PB_Image_DisplayFormat: Convertit l'image dans le format graphique du bureau (écran), pour avoir
                           des performances optimales lors de l'affichage de l'image. Cela veut aussi dire que l'image
                           peut être dégradée par rapport au fichier original, par exemple si le bureau est
                           en mode 16 bits alors que l'image est en 24 bits.

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

UseJPEGImageDecoder()
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).

OS Supportés

Tous