mirror of
https://gitee.com/openharmony/third_party_mesa3d
synced 2024-11-23 07:19:50 +00:00
29e3a11d78
This add a simple mechanism to select which GPU adapter the d3d12 driver should be using. A new environment variable is introduced. MESA_D3D12_DEFAULT_ADAPTER_NAME This represent a substring to search for in the GPU descrition, for example "NVIDIA" or "INTEL", or "NVIDIA GeForce RTX 3090", etc... GPU are searched in order and the first one to include the substring becomes a match. If no match is found, we default to the first enumerated GPU. Reviewed-by: Jesse Natalie <jenatali@microsoft.com> Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10710>
62 lines
1.5 KiB
ReStructuredText
62 lines
1.5 KiB
ReStructuredText
D3D12
|
|
=====
|
|
|
|
Overview
|
|
--------
|
|
|
|
The D3D12 driver is a Gallium driver that emits API calls for Microsoft's
|
|
:abbr:`D3D12 (Direct3D 12)` API instead of targeting a specific GPU
|
|
architecture. This can be used to get full desktop OpenGL 3.3 support on
|
|
devices that only support D3D12.
|
|
|
|
Debugging
|
|
---------
|
|
|
|
There's a few tools that are useful for debugging D3D12, such as these
|
|
environment variables:
|
|
|
|
.. envvar:: D3D12_DEBUG <flags> ("")
|
|
|
|
``verbose``
|
|
Enable verbose output to stdout
|
|
``blit``
|
|
Trace blit and copy resource calls
|
|
``experimental``
|
|
Enable experimental shader models feature
|
|
``dxil``
|
|
Dump DXIL during program compile
|
|
``disass``
|
|
Dump disassambly of created DXIL shader
|
|
``res``
|
|
Debug resources
|
|
``debuglayer``
|
|
Enable `debug layer`_
|
|
``gpuvalidator``
|
|
Enable `GPU validator`_
|
|
|
|
.. envvar:: DXIL_DEBUG <flags> ("")
|
|
|
|
``verbose``
|
|
Enable verbose output to stdout
|
|
``dump_blob``
|
|
Write shader blobs
|
|
``trace``
|
|
Trace instruction conversion
|
|
``dump_module``
|
|
dump module tree to stderr
|
|
|
|
.. _debug layer: https://docs.microsoft.com/en-us/windows/win32/direct3d12/understanding-the-d3d12-debug-layer
|
|
.. _GPU validator: https://docs.microsoft.com/en-us/windows/win32/direct3d12/using-d3d12-debug-layer-gpu-based-validation
|
|
|
|
Utilities
|
|
---------
|
|
|
|
Environment variables that control the behavior of the D3D12 driver.
|
|
|
|
.. envvar:: MESA_D3D12_DEFAULT_ADAPTER_NAME <string> ("")
|
|
|
|
Specifies a substring to search for when chosing a default adapter to run on.
|
|
The first adapter matching the substring is chosen. The substring is not
|
|
case sensitive.
|
|
|