Skip to content

Commit cdd2141

Browse files
authored
Merge pull request godotengine#8624 from bruvzg/upd_d3d12_docs
Update D3D12 build instructions.
2 parents 4a944b2 + 95a47f3 commit cdd2141

File tree

1 file changed

+17
-3
lines changed

1 file changed

+17
-3
lines changed

contributing/development/compiling/compiling_for_windows.rst

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -172,9 +172,6 @@ API.
172172

173173
To compile Godot with Direct3D 12 support you need at least the following:
174174

175-
- Visual Studio (follow the instructions above to install). Currently, we don't
176-
support building with Direct3D 12 enabled when using MinGW. Support will be
177-
added in the future if possible.
178175
- `The DirectX Shader Compiler <https://github.com/Microsoft/DirectXShaderCompiler/releases>`_.
179176
The zip folder will be named "dxc\_" followed by the date of release. Download
180177
it anywhere, unzip it and remember the path to the unzipped folder, you will
@@ -197,6 +194,12 @@ To compile Godot with Direct3D 12 support you need at least the following:
197194
./update_mesa.sh
198195
scons
199196

197+
If you are buildng with MinGW, add ``use_mingw=yes`` to the ``scons``
198+
command, you can also specify build architecture using ``arch={architecture}``.
199+
200+
Mesa static library should be built using the same compiler you are
201+
using for building Godot.
202+
200203
Optionally, you can compile with the following for additional features:
201204

202205
- `PIX <https://devblogs.microsoft.com/pix/download>`_ is a performance tuning
@@ -216,6 +219,17 @@ Optionally, you can compile with the following for additional features:
216219
.. note:: If you use a preview version of the Agility SDK, remember to enable
217220
developer mode in Windows; otherwise it won't be used.
218221

222+
.. note:: If you want to use a PIX with MinGW build, navigate to PIX runtime
223+
directory and use the following commands to generate import library::
224+
225+
# For x86-64:
226+
gendef ./bin/x64/WinPixEventRuntime.dll
227+
dlltool --machine i386:x86-64 --no-leading-underscore -d WinPixEventRuntime.def -D WinPixEventRuntime.dll -l ./bin/x64/libWinPixEventRuntime.a
228+
229+
# For ARM64:
230+
gendef ./bin/ARM64/WinPixEventRuntime.dll
231+
dlltool --machine arm64 --no-leading-underscore -d WinPixEventRuntime.def -D WinPixEventRuntime.dll -l ./bin/ARM64/libWinPixEventRuntime.a
232+
219233
When building Godot, you will need to tell SCons to use Direct3D 12 and where to
220234
look for the additional libraries:
221235

0 commit comments

Comments
 (0)