Document Metal support in Internal rendering architecture #9385
+39
−29
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Member
Calinou
commented
May 16, 2024
Calinou
commented
- Do not merge until Add Metal support for macOS (arm64) and iOS godot#88199 is merged.
Calinou
added
enhancement
area:contributing
Calinou
force-pushed
the
internal-rendering-architecture-metal
branch
2 times, most recently
from
e2b2752
to
fce5e23
Compare
Calinou
commented
May 31, 2024
contributing/development/core_and_modules/internal_rendering_architecture.rst
Show resolved
Hide resolved
skyace65
removed
the
waiting on PR merge
Calinou
force-pushed
the
internal-rendering-architecture-metal
branch
from
fce5e23
to
299dae4
Compare
tetrapod00
reviewed
Nov 10, 2024
Comment on lines
+98
to
+105
| 3 rendering *methods* (running over 4 rendering *drivers*) are available: | ||
|
|
||
| - **Forward+**, running over Vulkan / Direct3D 12 / Metal. The most advanced | ||
| graphics backend, suited for desktop platforms only. Used by default on | ||
| desktop platforms. | ||
| - **Forward Mobile**, running over Vulkan / Direct3D 12 / Metal. Less features, | ||
| but renders simple scenes faster. Suited for mobile and desktop platforms. | ||
| Used by default on mobile platforms. |
There was a problem hiding this comment.
Suggested change
| 3 rendering *methods* (running over 4 rendering *drivers*) are available: | |
| - **Forward+**, running over Vulkan / Direct3D 12 / Metal. The most advanced | |
| graphics backend, suited for desktop platforms only. Used by default on | |
| desktop platforms. | |
| - **Forward Mobile**, running over Vulkan / Direct3D 12 / Metal. Less features, | |
| but renders simple scenes faster. Suited for mobile and desktop platforms. | |
| Used by default on mobile platforms. | |
| Godot 4 includes three renderers: | |
| - **Forward+**. The most advanced renderer, suited for desktop platforms only. | |
| Used by default on desktop platforms. This renderer uses **Vulkan**, **Direct3D 12**, | |
| or **Metal** as the rendering driver, and it uses the **RenderingDevice** backend. | |
| - **Mobile**. Fewer features, but renders simple scenes faster. Suited for mobile | |
| and desktop platforms. Used by default on mobile platforms. This renderer uses | |
| **Vulkan**, **Direct3D 12**, or **Metal** as the rendering driver, and it uses | |
| the **RenderingDevice** backend. |
This is what I currently have for this section in #10183. It's word-for-word the same Renderers page summaryin that PR, too.
tetrapod00
reviewed
Nov 10, 2024
| @@ -736,7 +745,8 @@ Occlusion culling | |||
| ^^^^^^^^^^^^^^^^^ | |||
|
|
|||
| While modern GPUs can handle drawing a lot of triangles, the number of draw | |||
| calls in complex scenes can still be a bottleneck (even with Vulkan and Direct3D 12). | |||
| calls in complex scenes can still be a bottleneck (even with Vulkan, Direct3D 12 | |||
There was a problem hiding this comment.
Suggested change
| calls in complex scenes can still be a bottleneck (even with Vulkan, Direct3D 12 | |
| calls in complex scenes can still be a bottleneck (even with Vulkan, Direct3D 12, |
| @@ -270,10 +275,10 @@ To make the complexity of modern low-level graphics APIs more manageable, | |||
| Godot uses its own abstraction called RenderingDevice. | |||
|
|
|||
| This means that when writing code for modern rendering methods, you don't | |||
| actually use the Vulkan or Direct3D 12 APIs directly. While this is still | |||
| actually use the Vulkan, Direct3D 12 or Metal APIs directly. While this is still | |||
There was a problem hiding this comment.
Suggested change
| actually use the Vulkan, Direct3D 12 or Metal APIs directly. While this is still | |
| actually use the Vulkan, Direct3D 12, or Metal APIs directly. While this is still |
| @@ -108,7 +108,7 @@ Compatibility | |||
| .. note:: | |||
|
|
|||
| This is the only rendering method available when using the OpenGL driver. | |||
| This rendering method is not available when using Vulkan or Direct3D 12. | |||
| This rendering method is not available when using Vulkan, Direct3D 12 or Metal. | |||
There was a problem hiding this comment.
Suggested change
| This rendering method is not available when using Vulkan, Direct3D 12 or Metal. | |
| This rendering method is not available when using Vulkan, Direct3D 12, or Metal. |
| Godot also supports Metal rendering via `MoltenVK <https://github.com/KhronosGroup/MoltenVK>`__, | ||
| which is used as a fallback when native Metal support is not available (e.g. on x86 macOS). | ||
|
|
||
| **This driver is still experimental and only available in Godot 4.x (TODO) and later.** |
There was a problem hiding this comment.
Suggested change
| **This driver is still experimental and only available in Godot 4.x (TODO) and later.** | |
| **This driver is still experimental and only available in Godot 4.4 and later.** |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.