Cross Reference: /external/mesa3d/src/gallium/state_trackers/nine/

Quickstart Guide

*** Configure and build mesa
CFLAGS="-m32" CXXFLAGS="-m32" ./autogen.sh --prefix=/usr \
 --with-gallium-drivers=nouveau,r600,swrast --enable-nine \
 --with-gallium-driver-dir="`pwd`/src/gallium/targets/pipe-loader/.libs" \
 --enable-debug --enable-texture-float --with-dri-drivers= --disable-dri \
 --disable-opengl --disable-egl --disable-vdpau --disable-xvmc --disable-gbm \
 --disable-gallium-llvm
make

*** Then we create some symlinks to mesa:
ln -s "`pwd`/lib/gallium/libd3dadapter9.so.0.0.0" /usr/lib/
ln -s "`pwd`/lib/gallium/libd3dadapter9.so.0" /usr/lib/
ln -s "`pwd`/lib/gallium/libd3dadapter9.so" /usr/lib/
ln -s "`pwd`/include/d3dadapter" /usr/include/

*** Clone and build a patched wine
git clone git@github.com:iXit/wine.git
./configure
make

*** And finally we create some symlinks to our patched wine files:
for f in d3d9.dll gdi32.dll user32.dll wineps.drv winex11.drv;
do
    mv /usr/lib/wine/$f.so /usr/lib/wine/$f.so.old
    ln -s "`pwd`/dlls/`basename -s .dll $f`/$f.so" /usr/lib/wine/
done

*** Activating it within wine
regedit
Navigate to HKCU\Software\Wine\Direct3D
If it's not there, create it
Create a new DWORD value called UseNative
Set its value to 1

Every Direct3D9 program will now try using nine before wined3d

If you want to selectively enable it per-exe instead, use the key:
HKCU\Software\Wine\AppDefaults\app.exe\Direct3D\UseNative
where app.exe is the name of your .exe file


*** HOW IT WORKS ***

Nine implements the full IDirect3DDevice9 COM interface and a custom COM
interface called ID3DAdapter9 which is used to implement a final IDirect3D9Ex
COM interface.
ID3DAdapter9 is completely devoid of window system code, meaning this can be
provided by wine, Xlib, Wayland, etc. It's inadvisible to write a non-Windows
backend though, as we don't want to encourage linux developers to use this API.

The state tracker is compiled, along with pipe-loader, into a library called
libd3dadapter9.so. This library loads pipe_[driver].so drivers on demand and
exports a single symbol for getting a subsystem driver. Currently only DRM is
supported.
This library is then linked to the library implementing the IDirect3D9[Ex]
interface and the actual Direct3D9 entry points (Direct3DCreate9[Ex])

The implementation of IDirect3D9[Ex] lies within wine and coexists with
wined3d. It's loaded on demand and so if it's not there, it doesn't have any
drivers or something else is wrong, d3d9.dll will automatically revert to using
wined3d.
Whether or not it's even tried is determined by 2 DWORD registry keys.
> HKCU\Software\Wine\Direct3D\UseNative
> HKCU\Software\Wine\AppDefaults\app.exe\Direct3D\UseNative
The former is the global on-switch. The latter is per-exe.

The driver search path can be set at configure time with
--with-gallium-driver-dir and overridden at runtime with D3D9_DRIVERS_PATH.
Debugging information can be gotten with the WINEDEBUG channels d3d9 and
d3dadapter, and state_tracker debug information can be gotten with NINE_DEBUG.
Help on NINE_DEBUG is shown through NINE_DEBUG=help

Finally, the ID3DPresent[Group] and ID3DAdapter9 interfaces are not set in
stone, so feel free to hack on those as well as st/nine.

Happy Hacking!
Name	Date	Size
..	10-Aug-2018	4 KiB
.editorconfig	10-Aug-2018	47
adapter9.c	10-Aug-2018	46.4 KiB
adapter9.h	10-Aug-2018	5.4 KiB
authenticatedchannel9.c	10-Aug-2018	3 KiB
authenticatedchannel9.h	10-Aug-2018	2.7 KiB
basetexture9.c	10-Aug-2018	22.3 KiB
basetexture9.h	10-Aug-2018	5.2 KiB
buffer9.c	10-Aug-2018	16.1 KiB
buffer9.h	10-Aug-2018	4.5 KiB
cryptosession9.c	10-Aug-2018	4.2 KiB
cryptosession9.h	10-Aug-2018	3.5 KiB
cubetexture9.c	10-Aug-2018	12.2 KiB
cubetexture9.h	10-Aug-2018	3 KiB
device9.c	10-Aug-2018	142.6 KiB
device9.h	10-Aug-2018	29.8 KiB
device9ex.c	10-Aug-2018	16.8 KiB
device9ex.h	10-Aug-2018	6.8 KiB
device9video.c	10-Aug-2018	2.6 KiB
device9video.h	10-Aug-2018	2.5 KiB
guid.c	10-Aug-2018	4.8 KiB
guid.h	10-Aug-2018	1.4 KiB
indexbuffer9.c	10-Aug-2018	4.3 KiB
indexbuffer9.h	10-Aug-2018	2.7 KiB
iunknown.c	10-Aug-2018	8.3 KiB
iunknown.h	10-Aug-2018	5 KiB
Makefile.am	10-Aug-2018	265
Makefile.sources	10-Aug-2018	1.4 KiB
nine_buffer_upload.c	10-Aug-2018	9.1 KiB
nine_buffer_upload.h	10-Aug-2018	2.2 KiB
nine_csmt_helper.h	10-Aug-2018	15.9 KiB
nine_debug.c	10-Aug-2018	5.5 KiB
nine_debug.h	10-Aug-2018	4.3 KiB
nine_defines.h	10-Aug-2018	2.7 KiB
nine_dump.c	10-Aug-2018	31.8 KiB
nine_dump.h	10-Aug-2018	1.4 KiB
nine_ff.c	10-Aug-2018	96.9 KiB
nine_ff.h	10-Aug-2018	3.3 KiB
nine_flags.h	10-Aug-2018	298
nine_helpers.c	10-Aug-2018	3.1 KiB
nine_helpers.h	10-Aug-2018	4.8 KiB
nine_limits.h	10-Aug-2018	8.6 KiB
nine_lock.c	10-Aug-2018	104.5 KiB
nine_lock.h	10-Aug-2018	2.5 KiB
nine_pdata.h	10-Aug-2018	822
nine_pipe.c	10-Aug-2018	17 KiB
nine_pipe.h	10-Aug-2018	28.1 KiB
nine_queue.c	10-Aug-2018	7.3 KiB
nine_queue.h	10-Aug-2018	1.7 KiB
nine_quirk.c	10-Aug-2018	1.8 KiB
nine_quirk.h	10-Aug-2018	1.4 KiB
nine_shader.c	10-Aug-2018	118 KiB
nine_shader.h	10-Aug-2018	6.5 KiB
nine_state.c	10-Aug-2018	135.6 KiB
nine_state.h	10-Aug-2018	22.9 KiB
nineexoverlayextension.c	10-Aug-2018	2.2 KiB
nineexoverlayextension.h	10-Aug-2018	2.2 KiB
pixelshader9.c	10-Aug-2018	6.5 KiB
pixelshader9.h	10-Aug-2018	4 KiB
query9.c	10-Aug-2018	10.1 KiB
query9.h	10-Aug-2018	2.6 KiB
README	10-Aug-2018	3.1 KiB
resource9.c	10-Aug-2018	5.3 KiB
resource9.h	10-Aug-2018	2.6 KiB
stateblock9.c	10-Aug-2018	21.4 KiB
stateblock9.h	10-Aug-2018	2.2 KiB
surface9.c	10-Aug-2018	29.5 KiB
surface9.h	10-Aug-2018	5.5 KiB
swapchain9.c	10-Aug-2018	40.9 KiB
swapchain9.h	10-Aug-2018	5.1 KiB
swapchain9ex.c	10-Aug-2018	4.3 KiB
swapchain9ex.h	10-Aug-2018	2.4 KiB
texture9.c	10-Aug-2018	14.1 KiB
texture9.h	10-Aug-2018	2.7 KiB
threadpool.c	10-Aug-2018	5.2 KiB
threadpool.h	10-Aug-2018	2.1 KiB
vertexbuffer9.c	10-Aug-2018	3.9 KiB
vertexbuffer9.h	10-Aug-2018	2.6 KiB
vertexdeclaration9.c	10-Aug-2018	19.2 KiB
vertexdeclaration9.h	10-Aug-2018	3.3 KiB
vertexshader9.c	10-Aug-2018	8.5 KiB
vertexshader9.h	10-Aug-2018	4.3 KiB
volume9.c	10-Aug-2018	19.4 KiB
volume9.h	10-Aug-2018	3.6 KiB
volumetexture9.c	10-Aug-2018	10.2 KiB
volumetexture9.h	10-Aug-2018	2.8 KiB