Creates a new Quad.
The purpose of a Quad is to use a fraction of an image to draw objects, as opposed to drawing entire image. It is most useful for sprite sheets and atlases: in a sprite atlas, multiple sprites reside in same image, quad is used to draw a specific sprite from that image; in animated sprites with all frames residing in the same image, quad is used to draw specific frame from the animation.
![]() |
This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused! |
quad = love.graphics.newQuad( x, y, width, height, sw, sh )
number x
number y
number width
number height
number sw
number sh
Quad quad
img = love.graphics.newImage("mushroom-64x64.png") -- Let's say we want to display only the top-left -- 32x32 quadrant of the Image: top_left = love.graphics.newQuad(0, 0, 32, 32, img:getDimensions()) -- And here is bottom left: bottom_left = love.graphics.newQuad(0, 32, 32, 32, img:getDimensions()) function love.draw() love.graphics.draw(img, top_left, 50, 50) love.graphics.draw(img, bottom_left, 50, 200) -- v0.8: -- love.graphics.drawq(img, top_left, 50, 50) -- love.graphics.drawq(img, bottom_left, 50, 200) end