CreateSprite()

Syntaxe

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

Crée un nouveau #Sprite vide de dimension Largeur x Hauteur. Si #PB_Any est utilisé pour le paramètre '#Sprite', le numéro 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())
  DisplayShadowSprite() ou DisplaySolidSprite()
  #PB_Sprite_Texture: Le sprite est créé avec le support 3D (texture) nécessaire à la fonction CreateSprite3D() de la bibliothèque Sprite3D.
  #PB_Sprite_AlphaBlending: Sprite is created with per pixel alpha-channel support, the image format has to support it (only 
                            PNG and TIFF for now). The #PB_Sprite_Texture needs to be specified as well, and the sprite 
                            has to be displayed with DisplaySprite3D().

OS Supportés

Tous