GrabSprite

GrabSprite()

Syntaxe

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

Description

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.
Options (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().
                             La couleur transparente définie par défaut avec TransparentSpriteColor() est automatiquement appliquée.

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().
La couleur de transparence du sprite est automatiquement appliquée lors de l'utilisation de l'indicateur AlphaBlending.

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

<- FreeSprite() - Sprite Index - InitSprite() ->

#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.
Options (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(). La couleur transparente définie par défaut avec TransparentSpriteColor() est automatiquement appliquée.