Skip to content

Link to Resolution scaling documentation in Multiple resolutions #10955

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 16 additions & 8 deletions tutorials/rendering/multiple_resolutions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,11 @@ Nowadays, this is no longer the case, as there are plenty of different screen
sizes, densities, and aspect ratios. Non-conventional sizes are also becoming
increasingly popular, such as ultrawide displays.

For 3D games, there is not much of a need to support multiple resolutions (from
the aesthetic point of view). The 3D geometry will just fill the screen based on
the field of view, disregarding the aspect ratio. The main reason one may want
to support this, in this case, is for *performance* reasons (running in lower
resolution to increase frames per second).

For 2D and game UIs, this is a different matter, as art needs to be created
using specific pixel sizes in software such as Photoshop, GIMP or Krita.
For 3D rendering, there is not much of a need to support multiple resolutions.
Thanks to its vector-based nature, 3D geometry will just fill the screen based
on the viewport size. For 2D and game UIs, this is a different matter,
as art needs to be created using specific pixel sizes in software such
as Photoshop, GIMP or Krita.

Since layouts, aspect ratios, resolutions, and pixel densities can change so
much, it is no longer possible to design UIs for every specific screen.
Expand Down Expand Up @@ -122,6 +119,14 @@ most flexible way to deal with the problem, it can be a lot of work,
code and guessing, so Godot provides a set of parameters in the
project settings to handle multiple resolutions.

.. tip::

To render 3D at a lower resolution than 2D elements (without needing
separate viewports), you can use Godot's
:ref:`resolution scaling <doc_resolution_scaling>` support. This is a good way
to improve performance significantly in GPU-bottlenecked scenarios.
This works with any stretch mode and stretch aspect combination.

Stretch settings
----------------

Expand Down Expand Up @@ -373,6 +378,9 @@ Desktop game
- Set the stretch aspect to ``expand``. This allows for supporting multiple aspect ratios
and makes better use of tall smartphone displays (such as 18:9 or 19:9 aspect ratios).
- Configure Control nodes' anchors to snap to the correct corners using the **Layout** menu.
- For 3D games, consider exposing :ref:`doc_resolution_scaling` in the game's options menu
to allow players to adjust the 3D rendering resolution separately from UI elements.
This is useful for performance tuning, especially on lower-end hardware.

**Pixel art:**

Expand Down
Loading