Difference between revisions of "love.graphics.drawq"

m (Fix "changelog")
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{oldin|[[0.9.0]]|090|type=function|text=It has been merged into [[love.graphics.draw]]}}
 
Draw a Quad with the specified Image on screen.
 
Draw a Quad with the specified Image on screen.
 
== Function ==
 
== Function ==
Line 21: Line 22:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
== Changelog ==
+
== Function ==
{{Changelog/header}}
+
=== Synopsis ===
{{Changelog/item|0.8.0|Added shearing factors ''kx'' and ''ky''}}
+
<source lang="lua">
 +
love.graphics.drawq( canvas, quad, x, y, r, sx, sy, ox, oy, kx, ky )
 +
</source>
 +
=== Arguments ===
 +
{{param|Canvas|canvas|A canvas to texture the quad with.}}
 +
{{param|Quad|quad|The quad to draw on screen.}}
 +
{{param|number|x|The position to draw the object (x-axis).}}
 +
{{param|number|y|The position to draw the object (y-axis).}}
 +
{{param|number|r (0)|Orientation (radians).}}
 +
{{param|number|sx (1)|Scale factor (x-axis).}}
 +
{{param|number|sy (sx)|Scale factor (y-axis).}}
 +
{{param|number|ox (0)|Origin offset (x-axis).}}
 +
{{param|number|oy (0)|Origin offset (y-axis).}}
 +
{{New feature|0.8.0|
 +
{{param|number|kx (0)|Shearing factor (x-axis).}}
 +
{{param|number|ky (0)|Shearing factor (y-axis).}}
 +
|080}}
 +
=== Returns ===
 +
Nothing.
 +
== Examples ==
 +
=== Draw the top half of an image (the [[:File: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>
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]
 
* [[love.graphics.draw]]
 
* [[love.graphics.draw]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Sub-Category::Drawing| ]]
 
{{#set:Description=Draw a Quad with the specified Image on screen.}}
 
{{#set:Description=Draw a Quad with the specified Image on screen.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.graphics.drawq}}
 
{{i18n|love.graphics.drawq}}

Latest revision as of 02:03, 27 June 2019

Removed in LÖVE 0.9.0
It has been merged into love.graphics.draw.

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

See Also


Other Languages