{{newin|[[11.0]]|110|type=function}}

Sets the display mode and properties of the window, without modifying unspecified properties.

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

Changing the display mode may have side effects: for example, [[Canvas|canvases]] will be cleared. Make sure to save the contents of [[Canvas|canvases]] beforehand or re-draw to them afterward if you need to.
== Function ==
=== Synopsis ===
<source lang="lua">
success = love.window.updateMode( width, height, settings )
</source>
=== Arguments ===
{{param|number|width|Window width.}}
{{param|number|height|Window height.}}
{{param|table|settings|The settings table with the following optional fields. Any field not filled in will use the current value that would be returned by [[love.window.getMode]].}}
{{subparam|boolean|fullscreen|Fullscreen (true), or windowed (false).}}
{{subparam|FullscreenType|fullscreentype|The type of fullscreen to use.}}
{{subparam|boolean|vsync|True if LÖVE should wait for vsync, false otherwise.}}
{{subparam|number|msaa|The number of antialiasing samples.}}
{{subparam|boolean|resizable|True if the window should be resizable in windowed mode, false otherwise.}}
{{subparam|boolean|borderless|True if the window should be borderless in windowed mode, false otherwise.}}
{{subparam|boolean|centered|True if the window should be centered in windowed mode, false otherwise.}}
{{subparam|number|display|The index of the display to show the window in, if multiple monitors are available.}}
{{subparam|number|minwidth|The minimum width of the window, if it's resizable. Cannot be less than 1.}}
{{subparam|number|minheight|The minimum height of the window, if it's resizable. Cannot be less than 1.}}
{{subparam|boolean|highdpi|True if [[love.window.getDPIScale|high-dpi mode]] should be used on Retina displays in macOS and iOS. Does nothing on non-Retina displays.}}
{{subparam|number|x|The x-coordinate of the window's position in the specified display.}}
{{subparam|number|y|The y-coordinate of the window's position in the specified display.}}
=== Returns ===
{{param|boolean|success|True if successful, false otherwise.}}

== Notes ==
If fullscreen is enabled and the width or height is not supported (see [[love.window.getFullscreenModes]]), the window may be resized to the closest available resolution and a [[love.resize|resize]] event will be triggered.

If the fullscreen type is "desktop", then the window will be automatically resized to the desktop resolution.

Transparent backgrounds are currently not supported.

== See Also ==
* [[parent::love.window]]
* [[love.window.setMode]]
* [[love.window.getMode]]
* [[love.window.getFullscreenModes]]
* [[love.resize]]
[[Category:Functions]]
{{#set:Description=Sets the display mode and properties of the window, without modifying unspecified properties.}}
== Other Languages ==
{{i18n|love.window.updateMode}}