[[TracNav(TracNav/TOC_Development)]]
= Orxonox installation under Windows with Visual Studio =
== A Note ==
A note a the beginning: Currently, the visual studio project files generated by CMake don't yet work properly. I will be working on that soon however. [[br]]
The alternative is to use the manually maintained files by Reto for VS 2005 in the visual_studio folder of your source checkout. This however has a certain disadvantage: The project settings are quite complicated to be set (once you get the hang of it, it's easier than the normal way). So if you want to use Visual Studio to develop Orxonox, please contact [wiki:RetoGrieder me] first. [[br]]
This is why we recommend using MinGW and code::blocks when developing under Windows. The debugging is bit more complicated though.

== Preparations ==
 1. First, you need to see that you are DirectX ready. There is very good wiki [http://www.ogre3d.org/wiki/index.php/Building_From_Source#Visual_C.2B.2B_2005_.28VC8.2FSP1.29 article] on that on the Ogre website. Bear in mind that we ''only'' support Visual Studio 2005. Once the CMake generators work, it should be possible to use several versions. [[br]][[br]]

 1. The next thing is getting the external dependencies. We supply these as precompiled [http://svn.orxonox.net/ogre/binaries/VisualStudio8/ archives] (take the newest ones) with the lib, dll and include files all at once. There are also debug symbols, if you want to debug them. Once you got the archive, put it in the directory ''below'' your source checkout folder and extract it right there (not in a new folder). This will create a folder named "dependencies" that include everything necessary. You can proceed the same way with the debug symbols.[[br]][[br]]

 2. Run visual_studio/orxonox_vc8.sln now. When started, you can see all projects of the solution in the left window (otherwise get that window with ''View, Solution Explorer''). Now right click on ''orxonox'' and choose ''Set as StartUp Project''. Unfortunately you still have to specify the output working directory: Right click on ''orxonox'' again and choose ''properties''. Then in the upper left corner under ''configuration'' choose ''All configurations''. Then go to ''Debugging'' section and specify "$(OutDir)" as the ''working directory''. [[br]][[br]]

You should have a directory structure like this:
{{{
dependencies
 bin
 include
 lib
media (repository checkout, you choose the name..)
 ...
trunk (repository checkout, you choose the name..)
 bin
 cmake
 src
  audio
  ...
 visual_studio
  vc8
}}}