Skip to content

Commit c73e42b

Browse files
committed
Update Compiling for Windows following Direct3D 12 being enabled by default
The recommendation is now to leave `d3d12` to its default `yes` value, which means installing Direct3D 12 dependencies is considered required by default. You can still skip the dependencies by compiling with `d3d12=no`, which matches the behavior of self-compiled builds prior to Godot 4.6.
1 parent 40ec4bd commit c73e42b

File tree

1 file changed

+13
-8
lines changed

1 file changed

+13
-8
lines changed

engine_details/development/compiling/compiling_for_windows.rst

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@ Requirements
1515

1616
For compiling under Windows, the following is required:
1717

18-
1918
- A C++ compiler. Use one of the following:
2019

2120
- `Visual Studio Community <https://www.visualstudio.com/vs/community/>`_,
@@ -36,6 +35,8 @@ For compiling under Windows, the following is required:
3635
- `SCons 4.0+ <https://scons.org/pages/download.html>`_ build system. Using the
3736
latest release is recommended, especially for proper support of recent Visual
3837
Studio releases.
38+
- :ref:`Direct3D 12 dependencies <doc_compiling_for_windows_installing_d3d12_requirements>`
39+
(can be skipped with the ``d3d12=no`` SCons option if Direct3D 12 support is not desired).
3940

4041
.. note:: If you have `Scoop <https://scoop.sh/>`_ installed, you can easily
4142
install MinGW and other dependencies using the following command:
@@ -182,17 +183,21 @@ dependencies. Running it will bring up the Project Manager.
182183
:ref:`doc_data_paths_self_contained_mode` by creating a file called
183184
``._sc_`` or ``_sc_`` in the ``bin/`` folder.
184185

185-
Compiling with support for Direct3D 12
186-
--------------------------------------
186+
.. _doc_compiling_for_windows_installing_d3d12_requirements:
187+
188+
Installing Direct3D 12 requirements
189+
-----------------------------------
187190

188-
By default, builds of Godot do not contain support for the Direct3D 12 graphics
189-
API.
191+
By default, Windows builds of Godot contain support for the Direct3D 12 graphics
192+
API. Compiling with Direct3D 12 support requires additional dependencies
193+
to be installed. If you wish to skip this step, you can use the ``d3d12=no``
194+
SCons option.
190195

191196
You can install the required dependencies by running
192197
``python misc/scripts/install_d3d12_sdk_windows.py``
193-
in the Godot source repository. After running this script, add the ``d3d12=yes``
194-
SCons option to enable Direct3D 12 support. This will use the default paths for
195-
the various dependencies, which match the ones used in the script.
198+
in the Godot source repository. After running this script, compile Godot as usual.
199+
This will use the default paths for the various dependencies, which match the
200+
ones used in the script.
196201

197202
You can find the detailed steps below if you wish to set up dependencies
198203
manually, but the above script handles everything for you (including the

0 commit comments

Comments
 (0)