DXVK-2.5.3

Introduction to DXVK

The DXVK package contains DLL files which converts Direct3D 8-11 calls to Vulkan. By default in Wine, Direct3D 8-11 calls are converted to OpenGL calls in a poor manner, leading to bad performance. As such, many people install this package.

[Note]

Note

This may take a while to build. Feel free to do something else while this is building.

DXVK Dependencies

Required

git-2.48.1 (with cURL-8.12.1; to clone the repository), Glslang-15.1.0, MinGW-w64-GCC-14.2.0 (compiled with POSIX thread support), and Wine-10.1

Required (Runtime)

Vulkan-Loader-1.4.304

Installation of DXVK

Clone the repository using git-2.48.1 as this project depends on submodules, even if they are installed on the system:

git clone --recursive https://github.com/doitsujin/dxvk dxvk-2.5.3 &&
cd dxvk-2.5.3 &&
git checkout v2.5.3
[Note]

Note

If you are doing multilib, it is recommended to install 32-bit along with 64-bit DXVK as there are plenty of 32-bit Direct3D applications.

64-bit Installation

Install 64-bit DXVK by running the following commands:

mkdir build-win64 &&
cd    build-win64 &&

meson setup .. --cross-file ../build-win64.txt \
               --buildtype=release             \
               --prefix=$PWD/DESTDIR &&

ninja

Now as the root user:

ninja install &&
cd ..         &&

mkdir   -pv     /usr/lib/dxvk/win64 &&
install -vDm644 build-win64/DESTDIR/bin/*.dll \
                /usr/lib/dxvk/win64

32-bit Installation

Install 32-bit DXVK by running the following commands:

mkdir build-win32 &&
cd    build-win32 &&

meson setup .. --cross-file ../build-win32.txt \
               --buildtype=release             \
               --prefix=$PWD/DESTDIR &&

ninja

Now as the root user:

ninja install &&
cd ..         &&

mkdir   -pv     /usr/lib/dxvk/win32 &&
install -vDm644 build-win32/DESTDIR/bin/*.dll \
                /usr/lib/dxvk/win32

Setting Up DXVK

First, create the Wine prefix if it is not already made:

WINEPREFIX=~/.wine wineboot -u
[Note]

Note

wineboot may report an error in the output, but this is normal and frequent. Usually, these errors are non-fatal and you won't need to typically worry about them. Wine is very verbose.

While the DXVK DLL files have been installed, they are not yet in the Wine prefix. Create symlinks so that they can be found by Wine, whilst allowing updating of this package without having to copy everything over again. Along with this, the registry must be updated to use the new DLLs. Do this for each archetecture you have installed.

64-bit Setup

For 64-bit:

for DLL_FILE in /usr/lib/dxvk/win64/*.dll; do
    ln -sfv $DLL_FILE ~/.wine/drive_c/windows/system32/$(basename $DLL_FILE) &&
    DLL_FILE=$(basename $DLL_FILE | sed s/.dll//g) &&
    wine reg add \
        'HKEY_CURRENT_USER\Software\Wine\DllOverrides' \
        /v "$DLL_FILE" /d native /f
done

32-bit Setup

For 32-bit:

for DLL_FILE in /usr/lib/dxvk/win32/*.dll; do
    if [ ! -d ~/.wine/drive_c/windows/syswow64 ]; then
        ln -sfv $DLL_FILE ~/.wine/drive_c/windows/system32/$(basename $DLL_FILE)
    else
        ln -sfv $DLL_FILE ~/.wine/drive_c/windows/syswow64/$(basename $DLL_FILE)
    fi
    DLL_FILE=$(basename $DLL_FILE | sed s/.dll//g) &&
    wine reg add \
        'HKEY_CURRENT_USER\Software\Wine\DllOverrides' \
        /v "$DLL_FILE" /d native /f
done

Command Explanations

[Note]

Note

Inspect meson_options.txt for a full list of options.

git checkout v2.5.3: This command switches to a stable release in the commit history.

--cross-file=../build-win{32,64}.txt: This parameter changes what Win archetecture to build for.

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

WINEPREFIX=~/.wine wineboot -u: This command creates a Wine prefix and copies over any missing files to it. It will not reset an existing prefix.

wine{,64} reg add ...: This command overrides the registry so that Wine will use the new DLL files instead of the old ones.

Contents

Installed Programs: None
Installed Libraries: d3d10core.dll, d3d11.dll, d3d8.dll, d3d9.dll, and dxgi.dll
Installed Directories: /usr/lib/dxvk/{win32,win64}

Short Descriptions

d3d10core.dll

converts Direct3D 10 calls to Vulkan

d3d11.dll

converts Direct3D 11 calls to Vulkan

d3d8.dll

converts Direct3D 8 calls to Vulkan

d3d9.dll

converts Direct3D 9 calls to Vulkan

dxgi.dll

handles the Direct3D Graphics Infrastructure