From Gentoo Wiki
Jump to:navigation Jump to:search

DXVK is a Vulkan-based translation layer for Direct3D 9/10/11 which allows running 3D applications on Linux using Wine.



Quick start

To include both 64-bit and 32-bit bindings:

root #echo 'app-emulation/dxvk ABI_X86: 64 32' >> /etc/portage/package.use/dxvk
root #emerge --ask app-emulation/dxvk

USE flags

USE flags for app-emulation/dxvk Vulkan-based implementation of D3D9, D3D10 and D3D11 for Linux / Wine

crossdev-mingw Use sys-devel/crossdev for the toolchain rather than dev-util/mingw64-toolchain (requires manual setting up)
d3d10 Enable support for DirectX 10 (d3d10.dll)
d3d11 Enable support for DirectX 11 (d3d11.dll)
d3d9 Enable support for DirectX 9 (d3d9.dll)
debug Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces
dxgi Enable support for the DirectX Graphics Infrastructure (dxgi.dll)
strip Allow symbol stripping to be performed by the ebuild for special files

Using crossdev toolchain

To use toolchains compiled with sys-devel/crossdev rather than dev-util/mingw64-toolchain, they have to be set up like this:

It is recommended to create an ebuild repository by following this section in the Crossdev article.

Make sure that mingw64-runtime does not have the tools useflag enabled when bootstrapping. See bug #644556.
user $for toolchain in cross-x86_64-w64-mingw32 cross-i686-w64-mingw32; do
   crossdev --stable --libc ">=8.0.0" --target ${toolchain}
   crossdev --stable --libc ">=8.0.0" --lenv 'USE="libraries"' \
       --genv 'EXTRA_ECONF="--enable-threads=posix"' \
       --init-target --target ${toolchain}
   sed "s|-libraries ||" -i /etc/portage/package.use/${toolchain}
   emerge --oneshot ${toolchain}/mingw64-runtime
   emerge --oneshot ${toolchain}/gcc

Add --disable-sjlj-exceptions --with-dwarf2 to EXTRA_ECONF for cross-i686-w64-mingw32/gcc (but not for cross-x86_64-w64-mingw32/gcc) for improved performance.[1][2]

If crossdev generation of the target toolchain should fail, ensure that USE="libraries" is enabled on ${toolchain}/mingw64-runtime by simply prefixing the relevant emerge command with env USE="libraries", mirroring the application of the USE flag to libc via crossdev's lenv argument. Revert edits to /etc/portage/env/mingw-gcc.conf, /etc/portage/package.env/mingw, and /etc/portage/package.use/mingw before retrying, or toolchain generation will fail due to the --enable-threads flag.



Link the folder containing x32 and x64 to a subdirectory of ~/.local/share/lutris/runtime/dxvk.

user $mkdir -p ~/.local/share/lutris/runtime/dxvk
user $ln -s /usr/lib/dxvk ~/.local/share/lutris/runtime/dxvk/system

To use the newly installed DXVK, configure the Wine runner in the Lutris GUI, show advanced options, and enter the subdirectory name (system in this case) as DXVK version.


It is recommended to create the ~/.wine-32 or ~/.wine-64 directories for different architectures.

user $WINEPREFIX=~/.wine-64 setup_dxvk.sh install --symlink
user $WINEPREFIX=~/.wine-32 setup_dxvk.sh install --symlink

See also

  • Vulkan — a next-generation graphics API created by The Khronos Group.
  • Wine — an application compatibility layer that allows Microsoft Windows software to run on Linux and other POSIX-compliant operating systems.

External resources