Difference between revisions of "love.graphics.drawq"

m
(Added an example)
Line 42: Line 42:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
== Examples ==
 +
=== Draw the top half of an image (the [https://love2d.org/w/images/c/c3/Resource-HamsterBall.png Hamster Ball]) at 100 by 100 pixels. ===
 +
<source lang="lua">
 +
image = love.graphics.newImage("hamster.png")
 +
quad = love.graphics.newQuad(0, 0, 128, 64, image:getWidth(), image:getHeight())
 +
 +
function love.draw()
 +
love.graphics.drawq(image, quad, 100, 100)
 +
end
 +
</source>
 
== Changelog ==
 
== Changelog ==
 
{{Changelog/header}}
 
{{Changelog/header}}

Revision as of 06:41, 14 June 2013

Draw a Quad with the specified Image on screen.

Function

Synopsis

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

Arguments

Image image
An image to texture the quad with.
Quad quad
The quad to draw on screen.
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).
number sy (sx)
Scale factor (y-axis).
number ox (0)
Origin offset (x-axis).
number oy (0)
Origin offset (y-axis).
Available since LÖVE 0.8.0
number kx (0)
Shearing factor (x-axis).
number ky (0)
Shearing factor (y-axis).

Returns

Nothing.

Function

Synopsis

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

Arguments

Canvas canvas
A canvas to texture the quad with.
Quad quad
The quad to draw on screen.
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).
number sy (sx)
Scale factor (y-axis).
number ox (0)
Origin offset (x-axis).
number oy (0)
Origin offset (y-axis).
Available since LÖVE 0.8.0
number kx (0)
Shearing factor (x-axis).
number ky (0)
Shearing factor (y-axis).

Returns

Nothing.

Examples

Draw the top half of an image (the Hamster Ball) at 100 by 100 pixels.

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

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

Changelog

Version Description
0.8.0 Added shearing factors kx and ky

See Also


Other Languages