Difference between revisions of "love.graphics.setMode"

m (Testing.)
m (Fixed Removed, and conf.lua link.)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Changes the display mode.
+
{{oldin|[[0.9.0]]|090|type=function|text=Moved to the [[love.window]] module as [[love.window.setMode]]}}
 +
 
 +
Changes the window size, or the display mode if fullscreen.
  
 
If width or height is 0, setMode will use the width or height of the desktop.  
 
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, [[canvas]]es will be cleared; make sure to save their contents beforehand.
+
Changing the display mode may have side effects: for example, [[Canvas]]es will be cleared; make sure to save their contents beforehand.
 
== Function ==
 
== Function ==
{{oldin|[[0.9.0]]|090|type=variant}}
 
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 15: Line 16:
 
{{param|boolean|fullscreen (false)|Fullscreen (true), or windowed (false).}}
 
{{param|boolean|fullscreen (false)|Fullscreen (true), or windowed (false).}}
 
{{param|boolean|vsync (true)|True if LÖVE should wait for vsync, false otherwise.}}
 
{{param|boolean|vsync (true)|True if LÖVE should wait for vsync, false otherwise.}}
{{param|number|fsaa (0)|The number of FSAA-buffers.}}
+
{{param|number|fsaa (0)|The number of MSAA samples.}}
 
=== Returns ===
 
=== Returns ===
 
{{param|boolean|success|True if successful, false otherwise.}}
 
{{param|boolean|success|True if successful, false otherwise.}}
  
== Function ==
+
== Notes ==
{{newin|[[0.9.0]]|090|type=variant}}
+
If you have disabled the screen in [[Config_Files|conf.lua]] and use this function 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.
=== Synopsis ===
+
<source lang="lua">
+
success = love.graphics.setMode( width, height, flags )
+
</source>
+
=== Arguments ===
+
{{param|number|width|Display width.}}
+
{{param|number|height|Display height.}}
+
{{param|table|flags|The flags table with the options:}}
+
{{subparam|boolean|fullscreen (false)|Fullscreen (true), or windowed (false).}}
+
{{subparam|boolean|vsync (true)|True if LÖVE should wait for vsync, false otherwise.}}
+
{{subparam|number|fsaa (0)|The number of FSAA-buffers.}}
+
{{subparam|boolean|resizable (false)|True if the window should be resizable in windowed mode, false otherwise.}}
+
{{subparam|boolean|borderless (false)|True if the window should be borderless in windowed mode, false otherwise.}}
+
{{subparam|boolean|centered (true)|True if the window should be centered in windowed mode, false otherwise.}}
+
=== Returns ===
+
{{param|boolean|success|True if successful, false otherwise.}}
+
  
 
== See Also ==
 
== See Also ==
Line 43: Line 28:
 
{{#set:Description=Changes the display mode.}}
 
{{#set:Description=Changes the display mode.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
{{#set:Removed=000}}
+
{{#set:Removed=090}}
 
{{#set:Sub-Category=Window}}
 
{{#set:Sub-Category=Window}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.graphics.setMode}}
 
{{i18n|love.graphics.setMode}}

Latest revision as of 04:06, 10 September 2016

Removed in LÖVE 0.9.0
Moved to the love.window module as love.window.setMode.


Changes the window size, or the display mode if fullscreen.

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.graphics.setMode( width, height, fullscreen, vsync, fsaa )

Arguments

number width
Display width.
number height
Display height.
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 MSAA samples.

Returns

boolean success
True if successful, false otherwise.

Notes

If you have disabled the screen in conf.lua and use this function 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.

See Also



Other Languages