From af7c2aa74f97cbc07e9e9e86e1cacd1d558043ea Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Thu, 20 Jul 2023 15:23:03 +0200 Subject: [PATCH] Document HDR output issues in Troubleshooting --- about/troubleshooting.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/about/troubleshooting.rst b/about/troubleshooting.rst index 6a3105c62..08d757831 100644 --- a/about/troubleshooting.rst +++ b/about/troubleshooting.rst @@ -91,6 +91,29 @@ resolve this, open **Project > Project Settings** and enable **Display > Window > Dpi > Allow Hidpi**. On top of that, make sure your project is configured to support :ref:`multiple resolutions `. +The editor or project appears to have washed out colors +------------------------------------------------------- + +On Windows, this is usually caused by incorrect OS or monitor settings, as Godot +currently does not support :abbr:`HDR (High Dynamic Range)` *output* +(even though it may internally render in HDR). + +As `most displays are not designed to display SDR content in HDR mode `__, +it is recommended to disable HDR in the Windows settings when not running applications +that use HDR output. On Windows 11, this can be done by pressing +:kbd:`Windows + Alt + B` (this shortcut is part of the Xbox Game Bar app). +To toggle HDR automatically based on applications currently running, you can use +`AutoActions `__. + +If you insist on leaving HDR enabled, it is possible to somewhat improve the +result by ensuring the display is configured to use :abbr:`HGIG (HDR Gaming Interest Group)` +tonemapping (as opposed to :abbr:`DTM (Dynamic Tone Mapping)`), then +`using the Windows HDR calibration app `__. +It is also strongly recommended to use Windows 11 instead of Windows 10 when using HDR. +The end result will still likely be inferior to disabling HDR on the display, though. + +Support for HDR *output* is planned in a future release. + The editor/project freezes or displays glitched visuals after resuming the PC from suspend ------------------------------------------------------------------------------------------