love.graphics.draw

Draw objects on screen.

Function

Synopsis

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

Arguments

Drawable drawable
A drawable object.
number x
The position to draw the object (x-axis).
number y
The position to draw the object (y-axis).
number r (0)
Orientation (radians).
number sx (1)
Scale factor (x-axis). Can be negative.
number sy (sx)
Scale factor (y-axis). Can be negative.
number ox (0)
Origin offset (x-axis). (A value of 20 would effectively move your drawable object 20 pixels to the left.)
number oy (0)
Origin offset (y-axis). (A value of 20 would effectively move your drawable object 20 pixels up.)

Returns

Nothing.

Notes

love.graphics.draw() anchors from the top left corner by default.

You can specify a negative value for sx or sy to flip the drawable horizontally or vertically.

The pivotal point is (x, y) on the screen and (ox, oy) in the internal coordinate system of the drawable object, before rotation and scaling. The object is scaled by (sx, sy), then rotated by r around the pivotal point.

Examples

Draw an image at 50 by 50 pixels

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

function love.draw()
   love.graphics.draw(hamster, 50, 50)
end

See Also


Other Languages