ImageData:encode (Français)

Encde l'ImageData dans un format de fichier et l'écrit optionnellement dans le répertoire de sauvegarde.

Fonction

Disponible depuis LÖVE 0.10.0
Ce-tte variant n'est pas supporté-e par des versions plus anciennes.

Synopsis

filedata = ImageData:encode( format, filename )

Arguments

ImageEncodeFormat (Français) format
Le format dans lequel encoder l'image.
string (Français) filename (nil)
Le nom du fichier dans lequel il sera écrit. Si nil, aucun fichier ne sera écrit, mais le FileData sera tout de même retourné.

Retourne

FileData (Français) filedata
L'image encodée en tant que nouvel obket FileData.

Fonction

Disponible depuis LÖVE 0.8.0 et supprimé avec LÖVE 0.10.0
ce-tte variant n'est pas supporté dans des versions antérieures ou postérieures.

Synopsis

ImageData:encode( outFile )

Arguments

string (Français) outFile
Nom d'un fichier dans lequel les données encodées doivent être écrites. Le format sera automatiquement déduit depuis l'extension du fichier.

Retourne

Rien.

Fonction

Disponible depuis LÖVE 0.8.0 et supprimé avec LÖVE 0.10.0
ce-tte variant n'est pas supporté dans des versions antérieures ou postérieures.

Synopsis

ImageData:encode( outFile, format )

Arguments

string (Français) outFile
Nom d'un fichier dans lequel les données encodées doivent être écrites.
ImageEncodeFormat (Français) format
Le format dans lequel encoder l'image.

Retourne

Rien.

Fonction

Supprimé depuis LÖVE 0.8.0
ce-tte variant n'est plus supporté dans cette version et les versions ultérieures.

Synopsis

data = ImageData:encode( format )

Arguments

ImageEncodeFormat (Français) format
Le format dans lequel encoder l'image.

Retourne

Data (Français) data
Les données de l'image encodée.

Exemples

Trace un cercle dans un canvas, le sauvegarde en PNG et l'affiche à l'écran

 function love.load()
   canvas = love.graphics.newCanvas(800,600)
   love.graphics.setCanvas(canvas)
   love.graphics.circle("fill",200,200,100)
   -- Il faut changer le canvas actif pour pouvoir en tirer un imageData.
   love.graphics.setCanvas()
   imagedata = canvas:newImageData()
   imagedata:encode("tga", "test.png")
 end
 
 function love.draw()
   love.graphics.draw(canvas) -- trace le canvas à l'écran
 end

Notes d'utilisateurs

  • Si vous désirez que le fichier ai une extension lorsque sauvegardé, ajoutez le au nom de fichier. Par exemple :
    image:encode("png","aPngImage.png")
    
  • Le fichier n'est pas créé dans le dossier courant, mais à un emplacement dépendant du système, voir love.filesystem (Français).

Voir également


Autres langues