CatchImage()

Syntaxe

Resultat = CatchImage(#Image, AdresseMemoire [, Taille [, Options])

Charge l'image à partir de l'emplacement mémoire spécifié. 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 le 'Resultat' est 0, l'image n'a pas pu être chargée.

Cette commande est utile pour inclure directement des images (logo etc..) directement dans l'exécutable avec la commande BASIC IncludeBinary. Néanmoins, n'abusez pas de cette fonctionnalité car une image incluse dans un exécutable consomme automatiquement de la mémoire supplémentaire (car tout l'exécutable, y compris les images, sont chargées en mémoire). Quand une image n'est plus utile, elle peut être détruite avec la commande FreeImage() pour libérer de la mémoire.

Le paramètre facultatif 'Taille' indique la taille maximale (en octets) de l'image à charger. Il est très utile quand les images proviennent d'une source non fiable pour éviter un plantage si elles sont corrompues.

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 le support des formats d'images suivants:

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

Exemple:

  CatchImage(0, ?Logo)
  End

  DataSection
    Logo: IncludeBinary "Logo.bmp"
  EndDataSection

Notes: Le "?" est un pointeur vers un label. Vous trouverez plus d'informations au sujet des pointeurs et des accès mémoire ici
La taille des images est actuellement limitée à 8192x8192 pixels (si la mémoire disponible le permet).

OS Supportés

Tous