====== D3D9 Installation Tutorials ======
==== Ubuntu/Mint ====
This is a tutorial to enable Gallium Nine on Ubuntu and Linux Mint.
This tutorial is written for the latest version of Ubuntu available.

**Systems with older Intel cards are not supported by Nine since the Intel Gallium ([[https://phoronix.com/scan.php?page=news_item&px=Intel-ILO-Gallium3D-Dropping|ILO]]) driver doesn't work with 3D games currently.**

If you have an Intel GPU along with some other card, make sure you are using a recent kernel (>3.15) with render nodes enabled. Read up on DRI_PRIME to get your games using the second GPU. Always run games with thread_submit=true.

This tutorial is based on a fresh OS install. 


Step 1. Make sure your system is up to date. You can do this by running <code>sudo apt-get update && sudo apt-get upgrade</code> Type your root password, hit enter. Then, after a bit, verify the packages it wants to install seem reasonable, and press y and enter and grab a snack.

Step 2.  Make sure you are using the open source drivers. They are installed by default on fresh installs. If you are unsure, run the following command <code> glxinfo | grep 'OpenGL version string' | grep Mesa </code> If you see any matching lines, you are using the open source drivers.

 If you are using Catalyst, see here for uninstallation instructions: http://support.amd.com/en-us/kb-articles/Pages/Catalyst-Linux-Installer-Notes.aspx#Uninstall

If you are using the Nvidia blobs, run the installer with the –uninstall argument and root privileges.  

Step 3. Install  oibaf's PPA. To do that, run this command <code> sudo add-apt-repository ppa:oibaf/graphics-drivers</code> Enter your password and press Enter when requested.


Step 4. Install my wine PPA. Run the following <code>sudo add-apt-repository ppa:commendsarnex/winedri3</code>

Step 5. Update your system with the new packages. Run the command <code>sudo apt-get update && sudo apt-get upgrade</code> Again, verify what it's doing seems reasonable.
After that, run <code> sudo apt-get dist-upgrade </code> to update the important packages.

Step 6. Install wine. Run <code>sudo apt-get install aptitude && sudo aptitude install wine3.0</code> Now, wait for it to install.
You may have to accept an EULA agreement for Microsoft Corefonts. Read the EULA and use Tab and Enter to agree.

Step 7. Restart your computer to load the new graphics drivers.

Step 8a. If you are using PlayOnLinux, highlight your game, and click Configure. First, in the General tab, set the Wine version to System. Then, go into the Wine tab and click Configure wine. Finally, head to the Staging Tab at the top of the new window and check the option at the bottom named 'Enable Gallium Nine for better D3D9 graphic performance'. 


Step 8b. If you're not using PlayOnLinux, run <code>winecfg</code> in the WinePrefix you want to run your games in. If your WinePrefix is not in /home/user/.wine, you can change the location with the WINEPREFIX environment variable. For example, if my WinePrefix were in /home/sarnex/games, I would run <code>WINEPREFIX=/home/sarnex/games winecfg</code>
Go to the Staging Tab at the top of the winecfg window and check the option at the bottom named 'Enabled Gallium Nine for better D3D9 performance'.  

Step 9. Run your game in the terminal using <code>wine /path/to/the/game.exe</code> If you are using PlayOnLinux, you can highlight your game and click the Debug option on the left instead. 

If you see a green message saying “Native Direct3D 9 is active”, then it's working!

If you see “Native Direct3D 9 is disabled”, you forgot the checkbox in winecfg or didn't set your WinePrefix correctly!

If you see “Native Direct3D 9 will be unavailable”, something broke. Join IRC channel and ping me (nickname sarnex).

If you have any problems, questions or comments, join #d3d9 on irc.oftc.net!