Difference between revisions of "love.window.getMode"

(Created page with "{{newin|0.9.0|090|type=function|text=Moved from love.graphics.getMode}} Returns the current display mode. == Function == === Synopsis === <source lang="lua"> width, heig...")
 
m (Note that the first index is 1)
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function|text=Moved from [[love.graphics.getMode]]}}
 
{{newin|[[0.9.0]]|090|type=function|text=Moved from [[love.graphics.getMode]]}}
Returns the current display mode.
+
Gets the display mode and properties of the window.
  
 
== Function ==
 
== Function ==
Line 10: Line 10:
 
None.
 
None.
 
=== Returns ===
 
=== Returns ===
{{param|number|width|Display width.}}
+
{{param|number|width|Window width.}}
{{param|number|height|Display height.}}
+
{{param|number|height|Window height.}}
{{param|table|flags|The flags table with the options:}}
+
{{param|table|flags|Table with the window properties:}}
{{subparam|boolean|fullscreen (false)|Fullscreen (true), or windowed (false).}}
+
{{subparam|boolean|fullscreen|Fullscreen (true), or windowed (false).}}
{{subparam|boolean|vsync (true)|True if LÖVE should wait for vsync, false otherwise.}}
+
{{subparam|FullscreenType|fullscreentype|The type of fullscreen mode used.}}
{{subparam|number|fsaa (0)|The number of antialiasing samples.}}
+
{{subparam|number|vsync|1 if the graphics framerate is synchronized with the monitor's refresh rate, 0 otherwise.}}
{{subparam|boolean|resizable (false)|True if the window should be resizable in windowed mode, false otherwise.}}
+
{{subparam|number|msaa|The number of antialiasing samples used (0 if MSAA is disabled).}}
{{subparam|boolean|borderless (false)|True if the window should be borderless in windowed mode, false otherwise.}}
+
{{subparam|boolean|resizable|True if the window is resizable in windowed mode, false otherwise.}}
{{subparam|boolean|centered (true)|True if the window should be centered in windowed mode, false otherwise.}}
+
{{subparam|boolean|borderless|True if the window is borderless in windowed mode, false otherwise.}}
 +
{{subparam|boolean|centered|True if the window is centered in windowed mode, false otherwise.}}
 +
{{subparam|number|display|The index of the display the window is currently in, if multiple monitors are available. First is 1.}}
 +
{{subparam|number|minwidth|The minimum width of the window, if it's resizable.}}
 +
{{subparam|number|minheight|The minimum height of the window, if it's resizable.}}
 +
{{New feature|0.9.1|
 +
{{subparam|boolean|highdpi|True if [[love.window.getPixelScale|high-dpi mode]] is allowed on Retina displays in OS X. Does nothing on non-Retina displays.}} }}
 +
{{New feature|0.9.2|
 +
{{subparam|number|refreshrate|The refresh rate of the screen's current display mode, in Hz. May be 0 if the value can't be determined.}}
 +
{{subparam|number|x|The x-coordinate of the window's position in its current display.}}
 +
{{subparam|number|y|The y-coordinate of the window's position in its current display.}} }}
 +
{{Removed new feature|0.9.1|0.10.0|
 +
{{subparam|boolean|srgb|Removed in [[0.10.0]] (use [[love.graphics.isGammaCorrect]] instead). True if sRGB gamma correction is applied when drawing to the screen.}} }}
 +
 
 
== See Also ==
 
== See Also ==
 
* [[parent::love.window]]
 
* [[parent::love.window]]
 
* [[love.window.setMode]]
 
* [[love.window.setMode]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Returns the current display mode.}}
+
{{#set:Description=Gets the display mode and properties of the window.}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.window.getMode}}
 
{{i18n|love.window.getMode}}

Latest revision as of 17:50, 25 April 2023

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

Gets the display mode and properties of the window.

Function

Synopsis

width, height, flags = love.window.getMode( )

Arguments

None.

Returns

number width
Window width.
number height
Window height.
table flags
Table with the window properties:
boolean fullscreen
Fullscreen (true), or windowed (false).
FullscreenType fullscreentype
The type of fullscreen mode used.
number vsync
1 if the graphics framerate is synchronized with the monitor's refresh rate, 0 otherwise.
number msaa
The number of antialiasing samples used (0 if MSAA is disabled).
boolean resizable
True if the window is resizable in windowed mode, false otherwise.
boolean borderless
True if the window is borderless in windowed mode, false otherwise.
boolean centered
True if the window is centered in windowed mode, false otherwise.
number display
The index of the display the window is currently in, if multiple monitors are available. First is 1.
number minwidth
The minimum width of the window, if it's resizable.
number minheight
The minimum height of the window, if it's resizable.
Available since LÖVE 0.9.1
boolean highdpi
True if high-dpi mode is allowed on Retina displays in OS X. Does nothing on non-Retina displays.


Available since LÖVE 0.9.2
number refreshrate
The refresh rate of the screen's current display mode, in Hz. May be 0 if the value can't be determined.
number x
The x-coordinate of the window's position in its current display.
number y
The y-coordinate of the window's position in its current display.


Available since LÖVE 0.9.1 and removed in LÖVE 0.10.0
boolean srgb
Removed in 0.10.0 (use love.graphics.isGammaCorrect instead). True if sRGB gamma correction is applied when drawing to the screen.


See Also

Other Languages