PureBasic:LoadSprite

PureBasic:SpriteScreen

<< Précédent | Sommaire | Suivant >>

[modifier] Syntaxe

Resultat = LoadSprite(#Sprite, NomFichier$ [, Mode])

[modifier] Description

Charge en mémoire le #Sprite contenu dans NomFichier$.
Si #PB_Any est utilisé pour le paramètre '#Sprite', l'identifiant du nouveau sprite sera renvoyé dans 'Resultat'. Le sprite peut être au format BMP (non compressé) ou dans un des formats supportés par la bibliothèque ImagePlugin. Avant de charger un sprite, un écran doit être ouvert à l'aide de la commande OpenScreen() ou OpenWindowedScreen(). Si Resultat = 0, le chargement a échoué. Un Sprite chargé peut être libéré par la fonction FreeSprite(). Les commandes suivantes peuvent être utilisées pour activer automatiquement davantage de formats d'images:

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

Le paramètre 'Mode' est facultatif et peut prendre une des valeurs suivantes:

• 0  : Mode par défaut (le sprite est chargé dans la mémoire video, si possible)
• #PB_Sprite_Memory : Le sprite est chargé dans la mémoire principale du PC (plus lent sauf en mode SpecialFX())
• #PB_Sprite_Alpha  : Le sprite est au format 8 bits (256 couleurs) en niveau de gris utilisé par DisplayAlphaSprite(), DisplayShadowSprite() ou DisplaySolidSprite()
• #PB_Sprite_Texture: Le sprite est créé avec le support 3D (texture) nécessaire à la fonction CreateSprite3D() de la librarie Sprite3D.

Note: Pour les écrans en 256 couleurs (8 bits), seules les images BMP en 256 couleurs sont supportées.

[modifier] OS supportés

Windows, AmigaOS, Linux, MacOS X