Difference between revisions of "love.window.setMode"

m (Moved note about disabling the window to a dedicated notes section)
m (Added some functions to the 'see also' list)
Line 29: Line 29:
 
== See Also ==
 
== See Also ==
 
* [[parent::love.window]]
 
* [[parent::love.window]]
 +
* [[love.window.getMode]]
 +
* [[love.window.getModes]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Changes the display mode.}}
 
{{#set:Description=Changes the display mode.}}

Revision as of 15:32, 23 August 2013

Available since LÖVE 0.9.0
Moved from love.graphics.setMode.


Changes the display mode.

If width or height is 0, setMode will use the width or height of the desktop.

Changing the display mode may have side effects: for example, canvases will be cleared; make sure to save their contents beforehand.

Function

Synopsis

success = love.window.setMode( width, height, flags )

Arguments

number width
Display width.
number height
Display height.
table flags
The flags table with the options:
boolean fullscreen (false)
Fullscreen (true), or windowed (false).
boolean vsync (true)
True if LÖVE should wait for vsync, false otherwise.
number fsaa (0)
The number of antialiasing samples.
boolean resizable (false)
True if the window should be resizable in windowed mode, false otherwise.
boolean borderless (false)
True if the window should be borderless in windowed mode, false otherwise.
boolean centered (true)
True if the window should be centered in windowed mode, false otherwise.

Returns

boolean success
True if successful, false otherwise.

Notes

if you have disabled the window in conf.lua and use this functon to manually create the window, then you must not call any other love.graphics.* function before this one. Doing so will result in undefined behavior and/or crashes because OpenGL cannot function properly without a window.

See Also


Other Languages