From 36088f33a01212cae6106863af68277dc9dbcb2b Mon Sep 17 00:00:00 2001 From: skyace65 Date: Tue, 12 Nov 2024 20:22:21 -0500 Subject: [PATCH] Update recommended renderer for XR --- tutorials/rendering/renderers.rst | 11 ++++++----- tutorials/xr/setting_up_xr.rst | 5 +++-- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/tutorials/rendering/renderers.rst b/tutorials/rendering/renderers.rst index e71727985..06e58d53e 100644 --- a/tutorials/rendering/renderers.rst +++ b/tutorials/rendering/renderers.rst @@ -66,7 +66,7 @@ Choose **Forward+** if: Choose **Mobile** if: - - You are developing for newer mobile devices, XR, or desktop. + - You are developing for newer mobile devices, desktop XR, or desktop. - You have relatively new hardware which supports Vulkan, Direct3D 12, or Metal. - You are developing a 3D game. - You want to use advanced rendering features, subject to the limitations @@ -74,8 +74,8 @@ Choose **Mobile** if: Choose **Compatibility** if: - - You are developing for older mobile devices, or older desktop devices. The - Compatibility renderer supports the widest range of hardware. + - You are developing for older mobile devices, older desktop devices, or + standalone XR. The Compatibility renderer supports the widest range of hardware. - You are developing for web. In this case, Compatibility is the only choice. - You have older hardware which does not support Vulkan. In this case, Compatibility is the only choice. @@ -148,8 +148,9 @@ Overall comparison | | | | optimized. Use Mobile or | | | | | Compatibility instead. | +---------------------+--------------------------+--------------------------+--------------------------+ -| XR | ✔️ Yes. | ✔️ Yes. | ✔️ Yes. | -| | | | | +| XR | ✔️ Yes. Recommended for | ✔️ Yes. Recommended for | ⚠️ Supported, but poorly | +| | standalone headsets. | desktop headsets. | optimized. Use Mobile or | +| | | | Compatibility instead. | +---------------------+--------------------------+--------------------------+--------------------------+ | Web | ✔️ Yes. | ❌ No. | ❌ No. | +---------------------+--------------------------+--------------------------+--------------------------+ diff --git a/tutorials/xr/setting_up_xr.rst b/tutorials/xr/setting_up_xr.rst index dfdd4dbac..c3a41f3ef 100644 --- a/tutorials/xr/setting_up_xr.rst +++ b/tutorials/xr/setting_up_xr.rst @@ -39,8 +39,9 @@ While in Godot 3 most things worked out of the box, Godot 4 needs a little more As Godot 4 is still in development, many post process effects have not yet been updated to support stereoscopic rendering. Using these will have adverse effects. .. note:: - Godot 4 has 3 renderer options, Compatibility, Mobile, and Forward+. In the future XR desktop projects should use Forward+, and projects for stand-alone headsets - should use Mobile. However Compatibility is the recommended renderer for now due to it having the best XR performance. + Godot 4 has 3 renderer options, Compatibility, Mobile, and Forward+. In the future XR desktop projects should use Forward+, and projects for standalone headsets + should use Mobile. Currently Compatibility is the recommended renderer for standalone headsets, and ironically Mobile is the recommended renderer for desktop. + This is based on current XR performance on the different devices with each renderer. OpenXR ------