Browse Source

Add a Troubleshooting item about high CPU/GPU usage in the editor

See https://github.com/godotengine/godot/issues/42357.
Hugo Locurcio 4 years ago
parent
commit
682db43de5
1 changed files with 22 additions and 0 deletions
  1. 22 0
      about/troubleshooting.rst

+ 22 - 0
about/troubleshooting.rst

@@ -16,6 +16,28 @@ You should use the graphics driver provided by Intel rather than the one
 provided by your desktop or laptop's manufacturer because their version is often
 provided by your desktop or laptop's manufacturer because their version is often
 outdated.
 outdated.
 
 
+The editor runs slowly and uses all my CPU and GPU resources, making my computer noisy.
+---------------------------------------------------------------------------------------
+
+This is a known issue, especially on macOS since most Macs have Retina displays.
+Due to Retina displays' higher pixel density, everything has to be rendered at a
+higher resolution. This increases the load on the GPU and decreases perceived
+performance.
+
+There are several ways to improve performance and battery life:
+
+- In 3D, click the **Perspective** button in the top left corner and enable
+  **Half Resolution**. The 3D viewport will now be rendered at half resolution,
+  which can be up to 4 times faster.
+- Open the Editor Settings and increase the value of **Low Processor Mode Sleep Usec**
+  to ``33000`` (30 FPS). 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.
+- If you have a node that causes the editor to redraw continuously (such as
+  particles), hide it and show it using a script in the ``_ready()`` method.
+  This way, it will be hidden in the editor but will still be visible in the
+  running project.
+
 The grid disappears and meshes turn black when I rotate the 3D camera in the editor.
 The grid disappears and meshes turn black when I rotate the 3D camera in the editor.
 ------------------------------------------------------------------------------------
 ------------------------------------------------------------------------------------