CatchImage()

Syntaxe

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

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, 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. 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).

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.

Les commandes suivantes peuvent être utilisées pour activer automatiquement le support des formats d'images suivants:

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