mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2024-11-23 10:14:13 +08:00
4eef5628c8
The custom envvar directive is strange. It overloads the global namespace, where there's already a well-known envvar directive, but the envvar role won't resolve to envvars defined using the custom directive. It's not really critical to declare the type and default value here, and many descriptions already include this. Let's just use the plain one, and let the description take care of the details where needed. Reviewed-by: Yonggang Luo <luoyonggang@gmail.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19593>
66 lines
1.7 KiB
ReStructuredText
66 lines
1.7 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
|
|
|
|
Accepts the following comma-separated list of 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
|
|
|
|
Accepts the following comma-separated list of 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://learn.microsoft.com/en-us/windows/win32/direct3d12/understanding-the-d3d12-debug-layer
|
|
.. _GPU validator: https://learn.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
|
|
|
|
Specifies a substring to search for when choosing a default adapter to
|
|
run on. The first adapter matching the substring is chosen. The substring
|
|
is not case sensitive.
|
|
|