love.graphics.newImage (Français)

Crée une nouvelle Image depuis un chemin de fichier, FileData, une ImageData, ou une CompressedImageData, et génère optionnellement ou spécifie, des mipmaps pour l'image.

La version 11.0 à mis à jour love.graphics.newImage pour gérer les noms de fichiers se terminant par "@2x", "@3x", etc. comme facteur d'échelle de densité de pixel, si aucun n'est fourni explicitement.

O.png Cette fonction peut être lente si elle est appelée de façon répétée, comme depuis love.update ou love.draw. Si vous devez utiliser souvent une ressource spécifique, créez la une seule fois, et conservez la quelque part, elle peut être réutilisée !  



Fonction

Synopsis

image = love.graphics.newImage( filename )

Arguments

string (Français) filename
Le filepath (chemin de fichier) du fichier d'image.

Retourne

Image (Français) image
Un objet Image qui peut être tracé à l'écran.

Fonction

Synopsis

image = love.graphics.newImage( imageData )

Arguments

ImageData (Français) imageData
Un objet ImageData. L'Image utilisera cette ImageData pour se recharger elle-même lorsque love.window.setMode est appelée.

Retourne

Image (Français) image
Un objet Image qui peut être tracé à l'écran.

Fonction

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

Synopsis

image = love.graphics.newImage( compressedImageData )

Arguments

CompressedImageData (Français) compressedImageData
Un objet CompressedImageData. L'image utilisera cette CompressedImageData pour se recharger elle-même lrsque love.window.setMode (Français) est appelée.

Returns

Image (Français) image
Un objet Image qui peut être tracé à l'écran.

Fonction

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

Synopsis

image = love.graphics.newImage( filename, flags )

Arguments

string (Français) filename
Le filepath (chemin de fichier) du fichier d'image (ou bien un objet FileData (Français), ImageData (Français), CompressedImageData (Français) ou ByteData (Français)).
table (Français) flags
Une table contenant les champs suivants :
boolean (Français) linear (false)
True (vrai) si les pixels de l'image doivent être interprétés comme RGB linéaire, plutôt que comme encodé en sRGB, si rendu au gamma correct est activé. Il n'a aucun effet autrement.
boolean or table (Français) mipmaps (false)
Si true (vrai), Les mipmaps pour l'image seront générés automatiquement (ou bien pris depuis les fichiers d'images si possible, si l'image a pour origine une CompressedImageData). Si cette valeur est une table,, elle doit contenur une liste des autres noms de fichiers des images au même format dont les dimensions sont progressivement divisées par deux, jusqu'à l'image 1x1. Ces images seront utilsées en tant que les niveaux de mipmap de cette Image.

Retourne

Image (Français) image
Un nouvel objet Image qui peut être tracé à l'écran.

Fonction

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

Synopsis

image = love.graphics.newImage( filename, format )

Arguments

string (Français) filenamLe filepath (chemin de fichier) du fichier d'image (ou bien un objet FileData, un ImageData ou encore un CompressedImageData.)
Some description goes here.
TextureFormat (Français) format
Le format dans lequel interprété l'image.

Retourne

Image (Français) image
Un objet Image qui peut être tracé à l'écran.

Exemples

Trace un lapin à l'écran

function love.load()
	lapin = love.graphics.newImage("MonLapin.png")
end
function love.draw()
	love.graphics.draw(lapin, 0, 0)
end

Voir également


Autres langues