The primary responsibility for the love.graphics module is the drawing of lines, shapes, text, [[Image]]s and other [[Drawable]] objects onto the screen. Its secondary responsibilities include loading external files (including [[Image]]s and [[Font]]s) into memory, creating specialized objects (such as [[ParticleSystem]]s or [[Canvas]]es) and managing screen geometry.

LÖVE's coordinate system is rooted in the upper-left corner of the screen, which is at location (0, 0). The x axis is horizontal: larger values are further to the right. The y axis is vertical: larger values are further towards the bottom. It is worth noting that the location (0, 0) aligns with the upper-left corner of the pixel as well, meaning that for some functions you may encounter off-by-one problems in the render output when drawing 1 pixel wide lines. You can try aligning the coordinate system with the center of pixels rather than their upper-left corner. Do this by passing x+0.5 and y+0.5 or using love.graphics.translate().

[[File:lovecoordsystem.png|The LÖVE coordinate system]]

In many cases, you draw images or shapes in terms of their upper-left corner (See the picture above).


A note about angles in LÖVE: Angles are expressed in terms of [https://en.wikipedia.org/wiki/Radian radians], with values in the range of 0 to 2&Pi;  (approximately 6.28); you may be more used to working in terms of degrees.
Because of how the coordinate system is set up, with an origin in the upper left corner, angles in LÖVE may seem a bit backwards:  0 points right (along the X axis), &frac14;&Pi; points diagonally down and to the right, &frac12;&Pi; points directly down (along the Y axis), with increasing values continuing '''clockwise'''.


Many of the functions are used to manipulate the ''graphics coordinate system'', which is essentially the way coordinates are mapped to the display. You can change the position, scale, and even change rotation in this way.


== Types ==
{{#ask: [[Category:Types]] [[parent::love.graphics]] [[Concept:Current]]
| headers=hide
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}

== Functions ==
=== Drawing ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::Drawing]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}


=== Object Creation ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::Object Creation]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}


=== Graphics State ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::State]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}


=== Coordinate System ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::Coordinate System]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}


=== Window  ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::Window]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}


=== System Information  ===
{{#ask: [[Category:Functions]] [[parent::love.graphics]] [[Concept:Current]] [[Sub-Category::SystemInfo]]
| headers=hide
| limit=2000
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}

== Enums ==
{{#ask: [[Category:Enums]] [[parent::love.graphics]] [[Concept:Current]]
| headers=hide
| format=template
| template=ListingFields
| introtemplate=ListingIntro
| outrotemplate=ListingOutro
| ?Description
| ?PrettySince
| ?PrettyRemoved
}}

[[Category:Modules]]
{{#set:Description=Drawing of shapes and images, management of screen geometry.}}
== See Also ==
* [[parent::love]]
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.graphics}}