{{newin|[[0.9.2]]|092|type=function}}
Gets whether relative mode is enabled for the mouse.

If relative mode is enabled, the cursor is hidden and doesn't move when the mouse does, but relative mouse motion events are still generated via [[love.mousemoved]]. This lets the mouse move in any direction indefinitely without the cursor getting stuck at the edges of the screen.

The reported position of the mouse is not updated while relative mode is enabled, even when relative mouse [[love.mousemoved|motion events]] are generated.
== Function ==
=== Synopsis ===
<source lang="lua">
enabled = love.mouse.getRelativeMode( )
</source>
=== Arguments ===
None.
=== Returns ===
{{param|boolean|enabled|True if relative mode is enabled, false if it's disabled.}}
== See Also ==
* [[parent::love.mouse]]
* [[love.mouse.setRelativeMode]]
* [[love.mousemoved]]
[[Category:Functions]]
{{#set:Description=Gets whether relative mode is enabled for the mouse.}}
== Other Languages ==
{{i18n|love.mouse.getRelativeMode}}