From 4319e063b23c7c0632ef7223c5fa1911d91e3c08 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Thu, 12 Nov 2020 23:26:45 +0100 Subject: [PATCH] Document known issues with variable refresh rate in the editor See https://github.com/godotengine/godot/issues/38219. --- about/troubleshooting.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/about/troubleshooting.rst b/about/troubleshooting.rst index 13185f8d5..eb226ad43 100644 --- a/about/troubleshooting.rst +++ b/about/troubleshooting.rst @@ -38,6 +38,21 @@ There are several ways to improve performance and battery life: This way, it will be hidden in the editor but will still be visible in the running project. +The editor stutters and flickers on my variable refresh rate monitor (G-Sync/FreeSync). +--------------------------------------------------------------------------------------- + +This is a `known issue `__. +There are two workarounds for this: + +- Enable **Interface > Editor > Update Continuously** in the Editor Settings. Keep in mind + this will increase power usage and heat/noise emissions, since the editor will + now be rendering constantly, even if nothing has changed on screen. To + alleviate this, you can increase **Low Processor Mode Sleep Usec** to + ``33000`` (30 FPS) in the Editor Settings. This value determines the amount of + *microseconds* between frames to render. Higher values will make the editor + feel less reactive, but will help decrease CPU and GPU usage significantly. +- Alternatively, disable variable refresh rate on your monitor or in the graphics driver. + The grid disappears and meshes turn black when I rotate the 3D camera in the editor. ------------------------------------------------------------------------------------