SaveSprite()

Syntaxe

Resultat = SaveSprite(#Sprite, Fichier$ [, ImagePlugin [, Options]])
Description
Enregistre un Sprite dans un fichier.

Arguments

#Sprite Le sprite à enregistrer.
Fichier$ Le chemin et le nom du fichier à utiliser.
ImagePlugin (optionnel) Peut prendre l'une des constantes suivantes:
  #PB_ImagePlugin_BMP      : Enregistre l'image en BMP  (format par défaut)
  #PB_ImagePlugin_JPEG     : Enregistre l'image en JPEG (la commande UseJPEGImageEncoder() doit être utilisée)
  #PB_ImagePlugin_JPEG2000 : Enregistre l'image en JPEG2000 (la commande UseJPEG2000ImageEncoder() doit être utilisée)
  #PB_ImagePlugin_PNG      : Enregistre l'image en PNG  (la commande UsePNGImageEncoder() doit être utilisée)
Options (optionnel) Option de sauvegarde, dépendant du format d'enregistrement choisi.
Pour le moment, seul le réglage de la qualité de l'image est proposé.
Il est possible de régler la qualité d'une image à l'aide d'une valeur allant de 0 (plus mauvaise qualité) à 10 (qualité maximale). Seuls les plugins JPEG et JPEG2000 supportent cette option (la qualité par défaut est fixée à 7 si aucune option n'est spécifiée).

Valeur de retour

Renvoie une valeur non nulle si le sprite a été sauvegardé avec succès, zéro sinon.

Remarques

Par défaut, le format de sauvegarde est le BMP 24 bits.
Très utile avec la fonction GrabSprite() pour faire des copies d'écrans par exemple.

Exemple

InitSprite()
OpenScreen(800,600,32,"Sprite")
LoadSprite(0,#PB_Compiler_Home +"Examples/Sources/Data/PureBasicLogo.bmp")  
DisplaySprite(0, 200, 200)

 ;Capture de l'écran entier.
GrabSprite(1, 0, 0, 800, 600)

FlipBuffers()

 ;Enregistrement de la capture dans un fichier BMP.
 ;Vous pouvez choisir le chemin de l'enregistrement.
 ;Ici c'est le dossier courant ou le dossier personnel de l'utilisateur.
SaveSprite(1, "Ecran.bmp")

Delay(3000)  

Voir aussi

LoadSprite()

OS Supportés

Tous

<- RotateSprite() - Sprite Index - SpriteBlendingMode() ->