[[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. If I can find the time, I shall try to make it work, but it's going to be ugly.[[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). It is however not necessary to change these settings to develop orxonox with Visual Studio. So if you want to know more please contact [wiki:RetoGrieder me] first. [[br]]

== 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 SP1'''. 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 of 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/vc8/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:
{{{
media (repository checkout, you choose the name..)
 ...
trunk (repository checkout, you choose the name..)
 bin
 cmake
 dependencies
  bin
  boost-1.35.0
  ogre-1.4.9
  ...
 src
  audio
  ...
 visual_studio
  vc8
}}}