Gaming Linux® From Scratch (System V Edition) - Version #e05b

Chapter 18. Wine

VKD3D-Proton-2.14.1

Introduction to VKD3D-Proton

The VKD3D-Proton package contains DLL files which converts Direct3D 12 calls to Vulkan. By default in Wine, Direct3D 12 calls are also converted to Vulkan; however, this package makes more aggressive optimizations geared towards gaming and replaces the default implementation provided by Wine, VKD3D.

VKD3D-Proton Dependencies

Required

DXVK-2.6.2 (for dxgi and the configuration section), Glslang-15.3.0, MinGW-w64-GCC-15.1.0 (compiled with POSIX thread support), and Wine-10.10

Required (Runtime)

Vulkan-Loader-1.4.313

Downloading DXVK

This package depends on submodules and multiple of them will need to be downloaded. Create a list of the needed tarballs that will be downloaded: 

cat > vkd3d-proton-2.14.1-list << "EOF"
HansKristian-Work/vkd3d-proton/archive/v2.14.1/vkd3d-proton-2.14.1.tar.gz
KhronosGroup/SPIRV-Headers/archive/2b2e05e088841c63c0b6fd4c9fb380d8688738d3.tar.gz
KhronosGroup/Vulkan-Headers/archive/75ad707a587e1469fb53a901b9b68fe9f6fbc11f.tar.gz
HansKristian-Work/dxil-spirv/archive/47f8b0d6bba72431e89e896ac6c902309e0cf09b.tar.gz
KhronosGroup/SPIRV-Cross/archive/68300dc07ac3dc592dbbdb87e02d5180f984ad12.tar.gz
KhronosGroup/SPIRV-Headers/archive/3f17b2af6784bfa2c5aa5dbb8e0e74a607dd8b3b.tar.gz
KhronosGroup/SPIRV-Tools/archive/4d2f0b40bfe290dea6c6904dafdf7fd8328ba346.tar.gz
EOF

Download the tarballs using Wget-1.25.0: 

mkdir vkd3d-proton &&
cd    vkd3d-proton &&
grep -v '^#' ../vkd3d-proton-2.14.1-list | wget -i- -c \
    -B https://github.com

Installation of VKD3D-Proton

Extract all the tarballs: 

for i in *.tar.?z*; do
  echo "Extracting $i..."
  tar -xf $i
done

Now that the tarballs have been extracted, the submodules need to be moved in place. Do so now: 

mv -T SPIRV-Headers-2b2e05e088841c63c0b6fd4c9fb380d8688738d3                \
      vkd3d-proton-2.14.1/khronos/SPIRV-Headers                            &&
mv -T Vulkan-Headers-*                                                      \
      vkd3d-proton-2.14.1/khronos/Vulkan-Headers                           &&
mv -T dxil-spirv-*                                                          \
      vkd3d-proton-2.14.1/subprojects/dxil-spirv                           &&
mv -T SPIRV-Cross-*                                                         \
      vkd3d-proton-2.14.1/subprojects/dxil-spirv/third_party/SPIRV-Cross   &&
mv -T SPIRV-Headers-3f17b2af6784bfa2c5aa5dbb8e0e74a607dd8b3b                \
      vkd3d-proton-2.14.1/subprojects/dxil-spirv/third_party/spirv-headers &&
mv -T SPIRV-Tools-*                                                         \
      vkd3d-proton-2.14.1/subprojects/dxil-spirv/third_party/SPIRV-Tools

Go into the vkd3d-proton-2.14.1 directory: 

cd vkd3d-proton-2.14.1

Fix broken version generation which creates a broken header file during compilation: 

sed "165s/.*/  command : \['echo', '0'\],/" \
  -i meson.build
[Note]

Note

If you are doing multilib, it is up to you if you want to install the 32-bit DLL files from this package. Direct3D 12 released in mid-2015, so there are less 32-bit D3D12 applications than 64-bit ones. If you wish to stay on the safe side, it would be prudent to install the 32-bit DLL files as well.

64-bit Installation

Install 64-bit VKD3D-Proton 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/vkd3d-proton/win64 &&
install -vDm644 build-win64/DESTDIR/bin/*.dll \
                /usr/lib/vkd3d-proton/win64

32-bit Installation

Install 32-bit VKD3D-Proton 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/vkd3d-proton/win32 &&
install -vDm644 build-win32/DESTDIR/bin/*.dll \
                /usr/lib/vkd3d-proton/win32

Setting Up VKD3D-Proton

While the VKD3D-Proton 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/vkd3d-proton/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/vkd3d-proton/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 or meson.options for a full list of options.

git checkout v2.14.1: 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.

wine 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: d3d12core and d3d12 (all DLLs)
Installed Directories: /usr/lib/vkd3d-proton/{win32,win64}

Short Descriptions

d3d12core

contains the core Direct3D 12 API functions

d3d12

converts Direct3D 12 calls to Vulkan