GrabSprite()

Syntaxe

Resultat = GrabSprite(#Sprite, X, Y, Largeur, Hauteur [, Mode])

Capture une zone de l'écran et crée un nouveau Sprite avec son contenu.

Arguments

#Sprite	Le numéro d'identifiant du nouveau sprite. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y	Les coordonnées de la zone de capture, en pixels.
Largeur, Hauteur	Les dimensions de la zone de capture, en pixels.
Mode (optionnel)	Peut être une combinaison de (utiliser '|') #PB_Sprite_PixelCollision: Ajoute des informations spéciales pour gérer les collisions de pixels à travers SpritePixelCollision(). #PB_Sprite_AlphaBlending : Le sprite est créé avec un canal alpha (transparence), nécessaire pour utiliser DisplayTransparentSprite().

Valeur de retour

Renvoie une valeur non nulle si la capture s'est faite avec succès, zéro sinon.

Remarques

GrabSprite() doit toujours être appelé en dehors d'un bloc StartDrawing() : StopDrawing().

Exemple

InitSprite()

OpenScreen(800,600,32,"Sprite")
 
 ;Création du sprite 0
CreateSprite(0,200,200)
StartDrawing(SpriteOutput(0))
Circle(100, 100, 100, RGB(255,255,0))
StopDrawing()

 ;Affichage du sprite 0
DisplaySprite(0, 300, 200)

 ;Capture d'une zone de l'écran et création du sprite 1
GrabSprite(1, 400, 300, 100, 100)

 ;Affichage du sprite 1
DisplaySprite(1, 500, 100)

FlipBuffers()

Delay(5000)

Voir aussi

CreateSprite(), ClipSprite(), DisplaySprite(), DisplayTransparentSprite()

OS Supportés

Tous