Skip to content

Commit

Permalink
Document why Godot doesn't support changing the monitor resolution
Browse files Browse the repository at this point in the history
  • Loading branch information
Calinou committed Sep 18, 2020
1 parent 3f0a283 commit 131215a
Showing 1 changed file with 21 additions and 0 deletions.
21 changes: 21 additions & 0 deletions tutorials/viewports/multiple_resolutions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,23 @@ that are different from this base size. Godot offers many ways to
control how the viewport will be resized and stretched to different
screen sizes.

.. note::

Godot follows a modern approach to multiple resolutions. It will never change
the monitor's resolution on its own. While changing the monitor's resolution
is the most efficient approach, it's also the least reliable approach as it
can leave the monitor stuck on a low resolution if the game crashes. This is
especially common on macOS or Linux which don't handle resolution changes as
well as Windows.

Changing the monitor's resolution also removes any control from the game
developer over filtering and aspect ratio stretching, which can be important
to ensure correct display for pixel art games.

On top of that, changing the monitor's resolution makes alt-tabbing in and
out of a game much slower since the monitor has to change resolutions every
time this is done.

Resizing
--------

Expand Down Expand Up @@ -245,6 +262,10 @@ the game data is loaded::

VisualServer.texture_set_shrink_all_x2_on_set_data(true)

Alternatively, you can also enable mipmaps on all your 2D textures. However,
enabling mipmaps will increase memory usage which may be problematic on low-end
mobile devices.

Handling aspect ratios
----------------------

Expand Down

0 comments on commit 131215a

Please sign in to comment.