PureBasic:CreateSprite

PureBasic:SpriteScreen

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

[modifier] Syntaxe

Resultat = CreateSprite(#Sprite, Largeur, Hauteur [, Mode])

[modifier] Description

Crée un nouveau #Sprite vide de dimension Largeur x Hauteur.
Si #PB_Any est utilisé pour le paramètre '#Sprite', l'identifiant du nouveau sprite sera renvoyé dans 'Resultat'. Si Resultat = 0, la création a échouée. Avant de créer un sprite, un écran doit être ouvert à l'aide de la commande OpenScreen() ou OpenWindowedScreen(). Un Sprite ainsi créé peut être par la suite libéré par la fonction FreeSprite().

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 créé 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.