Difference between revisions of "love.resize"

(Created page with "{{newin|0.9.0|090|type=callback}} Callback function triggered when window is resized. == Function == === Synopsis === <source lang="lua"> love.resize( w, h ) </source> === Ar...")
 
m
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=callback}}
 
{{newin|[[0.9.0]]|090|type=callback}}
Callback function triggered when window is resized.
+
Called when the window is resized, for example if the user resizes the window, or if <code>love.window.setMode</code> is called with an unsupported width or height in fullscreen and the window chooses the closest appropriate size.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 11: Line 11:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
== Notes ==
 +
Calls to <code>love.window.setMode</code> will '''only''' trigger this event if the width or height of the window after the call doesn't match the requested width and height. This can happen if a fullscreen mode is requested which doesn't match any supported mode, or if the fullscreen type is [[FullscreenType|'desktop']] and the requested width or height don't match the desktop resolution.
 +
 +
Since [[11.0]], this function returns width and height in DPI-scaled units rather than pixels.
 
== Example ==
 
== Example ==
 
<source lang="lua">
 
<source lang="lua">
Line 19: Line 23:
 
== See Also ==
 
== See Also ==
 
* [[parent::love]]
 
* [[parent::love]]
 +
* [[love.window.setMode]]
 +
* [[love.window.setFullscreen]]
 +
* [[love.conf]]
 
[[Category:Callbacks]]
 
[[Category:Callbacks]]
{{#set:Description=Callback function triggered when window is resized.}}
+
{{#set:Description=Called when the window is resized.}}
 +
{{#set:Subcategory=Window}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.resize}}
 
{{i18n|love.resize}}

Latest revision as of 22:31, 7 March 2019

Available since LÖVE 0.9.0
This callback is not supported in earlier versions.

Called when the window is resized, for example if the user resizes the window, or if love.window.setMode is called with an unsupported width or height in fullscreen and the window chooses the closest appropriate size.

Function

Synopsis

love.resize( w, h )

Arguments

number w
The new width.
number h
The new height.

Returns

Nothing.

Notes

Calls to love.window.setMode will only trigger this event if the width or height of the window after the call doesn't match the requested width and height. This can happen if a fullscreen mode is requested which doesn't match any supported mode, or if the fullscreen type is 'desktop' and the requested width or height don't match the desktop resolution.

Since 11.0, this function returns width and height in DPI-scaled units rather than pixels.

Example

function love.resize(w, h)
  print(("Window resized to width: %d and height: %d."):format(w, h))
end

See Also


Other Languages