love.graphics.draw (Français)

Trace des objets Drawable (traçable), tels que les objets Image, Canvas, SpriteBatch, ParticleSystem, Mesh, Text, ou Video) à l'écran avec une rotation, mise à l'échelle ou étirement optionnels.

Les Objects sont tracés relativement à leurs systèmes de coordonnées locaux. L'origine est par défaut située à l'angle haut et gauche de l'Image et du Canvas. Tous les arguments de changement d'échelle, déformation et rotation transforment l'objet relativement à ce point. La position d'origine peut également être spécifiée dans le système de coordonnées de l'écran.

Il est possible de tourner un objet depuis son centre en décalant l'origine vers son centre. Les angles doivent être donnés en radians pour la rotation. Il est également possible de donner un facteur d'échelle négatif pour inverser par rapport à sa ligne centrale.

Il faut noter que les décalages sont appliqués avant la rotation, changement d'échelle ou déformation ; les changements d'échelle et déformations sont appliqués avant la rotation.

Les côtés droit et bas de l'objet sont décalés d'un angle défini par les facteurs de déformation.

Lorsque le shader par défaut est utilisé, tout ce qui sera travé avec cette fonction sera tinté en fonction de la couleur actuellement sélectionnée. Il faut le régler à blanc pur pour préserver les couleurs originelles de l'objet.

Fonction

Synopsis

love.graphics.draw( drawable, x, y, r, sx, sy, ox, oy, kx, ky )

Arguments

Drawable (Français) drawable
Un objet traçable.
number (Français) x (0)
Position à laquelle tracer l'objet (axe des x).
number (Français) y (0)
Position à laquelle tracer l'objet (axe des y).
number (Français) r (0)
Orientation (radians).
number (Français) sx (1)
Facteur d'échelle (axe des x).
number (Français) sy (sx)
Facteur d'échelle (axe des y).
number (Français) ox (0)
Décalage de l'origine (axe des x).
number (Français) oy (0)
Décalage de l'origine (axe des y).
Disponible depuis LÖVE 0.8.0
number (Français) kx (0)
Facteur de déformation (axe des x).
number (Français) ky (0)
Facteur de déformation (axe des y).

Retourne

Rien .

Fonction

Disponible depuis LÖVE 0.9.0
Elle remplace love.graphics.drawq.

Synopsis

love.graphics.draw( texture, quad, x, y, r, sx, sy, ox, oy, kx, ky )

Arguments

Texture (Français) texture
Une Texture (Image ou Canvas) avec laquelle texturer un Quad.
Quad (Français) quad
Quad à tracer à l'écran.
number (Français) x
Position à laquelle tracer l'objet (axe des x).
number (Français) y
Position à laquelle tracer l'objet (axe des y).
number (Français) r (0)
Orientation (radians).
number (Français) sx (1)
Facteur d'échelle (axe des x).
number (Français) sy (sx)
Facteur d'échelle (axe des y).
number (Français) ox (0)
Décalage de l'origine (axe des x).
number (Français) oy (0)
Décalage de l'origine (axe des y).
number (Français) kx (0)
Facteur de déformation (axe des x).
number (Français) ky (0)
Facteur de déformation (axe des y).

Retourne

Rien.

Fonction

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

Synopsis

love.graphics.draw( drawable, transform )

Arguments

Drawable (Français) drawable
Un objet traçable.
Transform (Français) transform
Objet transformation.

Retourne

Rien.

Fonction

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

Synopsis

love.graphics.draw( texture, quad, transform )

Arguments

Texture (Français) texture
Une Texture (Image ou Canvas) avec laquelle texturer un Quad.
Quad quad (Français)
Quad à tracer à l'écran.
Transform (Français) transform
Objet transformation.

Retourne

Rien.

Exemples

Trace une image (la balle de Hamster) à 100 par 100 pixels

function love.load()
   hamster = love.graphics.newImage("hamster.png")
end
function love.draw()
   love.graphics.draw(hamster, 100, 100)
end

Trace une image (la balle de Hamster) depuis son centre, à 100 par 100 pixels, tourné de 90 degrés

function love.load()
   hamster = love.graphics.newImage("hamster.png")
   width = hamster:getWidth()
   height = hamster:getHeight()
end
function love.draw()
   love.graphics.draw(hamster, 100, 100, math.rad(90), 1, 1, width / 2, height / 2)
end

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

Trace la moitié haute d'une image (la balle de hamster) à 100 par 100 pixels.

function love.load()
   image = love.graphics.newImage("hamster.png")
   quad = love.graphics.newQuad(0, 0, 128, 64, image:getWidth(), image:getHeight())
end

function love.draw()
	love.graphics.draw(image, quad, 100, 100)
end

Voir également


Autres langues