Draws a Drawable object (an Image, Canvas, SpriteBatch, ParticleSystem, Mesh, Text object, or Video) on the screen with optional rotation, scaling and shearing.
Objects are drawn relative to their local coordinate system. The origin is by default located at the top left corner of Image and Canvas. All scaling, shearing, and rotation arguments transform the object relative to that point. Also, the position of the origin can be specified on the screen coordinate system.
It's possible to rotate an object about its center by offsetting the origin to the center. Angles must be given in radians for rotation. One can also use a negative scaling factor to flip about its centerline.
Note that the offsets are applied before rotation, scaling, or shearing; scaling and shearing are applied before rotation.
The right and bottom edges of the object are shifted at an angle defined by the shearing factors.
When using the default shader anything drawn with this function will be tinted according to the currently selected color. Set it to pure white to preserve the object's original colors.
love.graphics.draw( drawable, x, y, r, sx, sy, ox, oy, kx, ky )
Drawable drawable
number x (0)
number y (0)
number r (0)
number sx (1)
number sy (sx)
number ox (0)
number oy (0)
number kx (0)
number ky (0)
Nothing.
Available since LÖVE 0.9.0 |
It has replaced love.graphics.drawq. |
love.graphics.draw( texture, quad, x, y, r, sx, sy, ox, oy, kx, ky )
Texture texture
Quad quad
number x
number y
number r (0)
number sx (1)
number sy (sx)
number ox (0)
number oy (0)
number kx (0)
number ky (0)
Nothing.
Available since LÖVE 11.0 |
This variant is not supported in earlier versions. |
love.graphics.draw( drawable, transform )
Nothing.
Available since LÖVE 11.0 |
This variant is not supported in earlier versions. |
love.graphics.draw( texture, quad, transform )
Texture texture
Quad quad
Transform transform
Nothing.
function love.load() hamster = love.graphics.newImage("hamster.png") end function love.draw() love.graphics.draw(hamster, 100, 100) end
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
Available since LÖVE 0.9.0 |
This functionality is not supported in earlier versions. |
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