4 | | === Installing the MinGW, msys & Libraries === |
5 | | 1. First of all you need subversion from [subversion.tigris.org]. There is also a GUI version at [http://tortoisesvn.tigris.org] (The command line version is good if you are experienced with the shell, otherwise download the GUI version) |
6 | | 1. Download and install [http://svn.orxonox.net/webdev/develop/win32/dev/MinGW-4.1.0.exe minGW] |
7 | | 1. Download [http://svn.orxonox.net/webdev/develop/win32/dev/MSYS-1.0.10.exe msys] |
8 | | 1. Install msys on another path than minGW |
9 | | 2. During the installation process answer yes (y) twice |
10 | | 3. Type in the exact path of minGW directory, so msys can configure the important links. |
11 | | 1. Install [http://svn.orxonox.net/webdev/develop/win32/dev/msysDTK-1.0.1.exe msysDTK] to the same direcory as msys. |
12 | | 1. Extract the [http://svn.orxonox.net/webdev/develop/win32/dev/toMSYS.rar toMSYS.rar] to the same direcory as msys. |
13 | | 1. Extract the [http://svn.orxonox.net/webdev/develop/win32/dev/toMinGW.rar toMinGW.rar] to the same direcory as minGW. |
14 | | 1. Download and install the newest version of Trolltech's Qt at http://www.trolltech.com |
15 | | 1. Optionally you can download the [http://svn.orxonox.net/webdev/develop/win32/runtime/ Orxonox runtime] libraries |
| 4 | === MinGW C++ Toolbox === |
| 5 | Download the '''MinGW C++ Toolbox''' provided on the [http://prdownloads.sourceforge.net/ogre/MinGW_Toolbox_Setup_wr1.exe?download Ogre SF files site]. MinGW must be setup before running Code::Blocks for the first time to make detection of MinGW go smoothly. |
| 6 | |
| 7 | Download the [http://prdownloads.sourceforge.net/ogre/MinGW_Toolbox_Setup_wr1.exe?download installer package] which will install the following in your mingw directory ie c:\mingw. |
| 8 | * gcc-core-3.4.5-20060117-1 |
| 9 | * gcc-g++-3.4.5-20060117-1 with modified libstdc++ with dynamic string and wide string support ([http://gcc.gnu.org/onlinedocs/gcc-3.4.6/gcc/ online Manual]) |
| 10 | * w32api-3.8 |
| 11 | * binutils-2.17.50-20070129-1 ([http://sourceware.org/binutils/docs-2.17/binutils/index.html online Manual]) |
| 12 | * mingw-runtime-3.11 |
| 13 | * gdb-6.3-2.exe ([http://sources.redhat.com/gdb/current/onlinedocs/gdb_toc.html online Manual]) |
| 14 | * !DrMingw ([http://jrfonseca.planetaclix.pt/projects/gnu-win32/software/drmingw/index.html online manual]) |
18 | | === Compilation === |
19 | | 1. Start msys |
20 | | 1. Go to the project directory |
21 | | {{{ |
22 | | $ cd orxonox |
23 | | }}} |
24 | | 1. Run |
25 | | {{{ |
26 | | $ ./autogen.sh |
27 | | $ ./configure |
28 | | $ make |
29 | | }}} |
30 | | (note that all packages can be downloaded from from http://mingw.org) |
| 17 | [[br]] |
| 18 | === MSYS === |
| 19 | Download the MSYS Installer from [http://svn.orxonox.net/webdev/develop/win32/dev/MSYS-1.0.10.exe here]. MSYS (Minimal SYStem) is a software port of the Unix-Shell to Windows. It's used by MinGW-Developers as a minimal system which can, for example, execute configure-scripts. |
| 20 | 1. Install MSYS into another path than MinGW |
| 21 | 1. During the installation process answer yes (y) twice |
| 22 | 1. Type in the exact path of MinGW directory, so MSYS can configure the important links. |
| 23 | |
| 24 | |
| 25 | [[br]] |
| 26 | === SVN === |
| 27 | Now you need to get subversion from [http://subversion.tigris.org]. There is also a very useful GUI-version at [http://tortoisesvn.tigris.org] (The command line version is good if you are experienced with the shell, otherwise download the GUI-version). |
| 28 | |
| 29 | |
| 30 | [[br]] |
| 31 | === Get the Ogre source === |
| 32 | Check out the Ogre-repository from https://svn.orxonox.net/ogre into a folder named 'ogre', for example 'c:\orxonox\ogre'. |
| 33 | * svn co !https://svn.orxonox.net/ogre ogre |
| 34 | (Or do it with [http://tortoisesvn.tigris.org TortoiseSVN], the GUI-version of SVN) |
| 35 | |
| 36 | |
| 37 | [[br]] |
| 38 | === Dependencies for Code::Blocks + MingW === |
| 39 | For building Ogre 1.4.x source, you will need the [http://downloads.sourceforge.net/ogre/OgreDependencies_CBMinGW_Eihort_20070325.zip?use_mirror=internap Ogre 1.4.x Dependencies]. It has all the dependencies built for use with Ogre 1.4.x including the debug and release import libs built from the August 2006 DirectX SDK. Don't use the ones that come with MingW. |
| 40 | |
| 41 | Unzip the dependencies into your ogre directory, in our example: 'c:\orxonox\ogre'. |
| 42 | |
| 43 | |
| 44 | [[br]] |
| 45 | === DirectX 9.0c August 2006 edition === |
| 46 | [http://www.microsoft.com/downloads/details.aspx?FamilyId=C72D9F1E-53F3-4747-8490-6801D8E8B4EF&displaylang=en Download the SDK]. You will need the DirectX SDK if you plan to build and run in '''debug mode''' when using '''Direct3D9''' Rendering mode. If you plan on building Ogre from source at a later date then you will need the DirectX SDK also. Note that this SDK doesnt work on Windows 2000 or less. |
| 47 | |
| 48 | |
| 49 | [[br]] |
| 50 | === Code::Blocks === |
| 51 | The easiest way to compile Ogre is using the [http://www.codeblocks.org/ Code::Blocks] project files. [http://forums.codeblocks.org/index.php?board=20.0 Use latest Nightly Build]. The Ogre sample project files will not work with Code::Blocks nightly builds prior to Jan 29 2007. |
| 52 | |
| 53 | * '''DO NOT USE Code::Blocks 1.0 RC2 or earlier, you must use a recent Nightly build or build from svn HEAD.''' |
| 54 | * Do not install the Nightly build over 1.0 RC2 or you will experience crashes. Unzip the build into a clean directory. You can unzip Nightly builds into a previous nightly build with no problems. |
| 55 | |
| 56 | There are two downloads you must get from the Nightly build post: |
| 57 | * wxmsw26u_gcc_cb.7z |
| 58 | * CB_2006xxxx_revxxxx_win32.7z |
| 59 | Unzip wxmsw26u_gcc_cb.7z witz [http://www.7-zip.org/ 7zip] into the directory you will unzip CB into. You may have to '''copy''' mingwm10.dll from the MinGW bin directory to the Code::Blocks bin directory if you didn't download it from the Nightly Build page. |
| 60 | |
| 61 | There are some more detailed install instructions that can be found on the [http://wiki.codeblocks.org/index.php?title=Installing_Code::Blocks_nightly_build_on_Windows Code::Blocks wiki site]. |
| 62 | |
| 63 | Make sure that Code::Blocks found your MinGW C++ Toolbox installation by following these instructions here: [http://www.ogre3d.org/wiki/index.php/Code_Blocks_Compiler_Setup Code Blocks Compiler Setup]. |
| 64 | |
| 65 | |
| 66 | [[br]] |
| 67 | === Directory setup in Code::Blocks === |
| 68 | [[Image(CB_SetC_D.jpg, nolink, border=0)]] |
| 69 | In the settings menu select Compiler and Debugger to setup the directories. |
| 70 | |
| 71 | [[br]] |
| 72 | [[Image(CB_CompilerDir.jpg, nolink, border=0)]] |
| 73 | Setup the include directories for the compiler. |
| 74 | |
| 75 | [[br]] |
| 76 | [[Image(CB_LinkerDir.jpg, nolink, border=0)]] |
| 77 | Setup the lib directories for the linker. Note that DirectX SDK lib is not used. The import libs in the Ogre dependencies will be used instead since MingW cannot link directly to the libs provided in the DirectX SDK. |
| 78 | |
| 79 | [[br]] |
| 80 | [[Image(CB_ResDir.jpg, nolink, border=0)]] |
| 81 | Include directory for windows resource compiler. |
| 82 | |
| 83 | |
| 84 | [[br]] |
| 85 | === Building Ogre === |
| 86 | To build Ogre, open Ogre_stlp.workspace in Code::Blocks. Make sure you use '''Ogre.workspace''' and not Ogre_stlp.workspace. Ogre_stlp.workspace is for Code::Blocks + MinGW + STLPort. |
| 87 | |
| 88 | [[Image(CB_BuildWorkspace.jpg, nolink, border=0)]] |
| 89 | |
| 90 | In the build menu select '''Build Workspace'''. This will build the debug and release targets of all projects listed in the workspace manager window. This will take some time, so have a break. |
| 91 | |
| 92 | If everything worked, you'll have several binaries and libraries in your ogre\Samples\Common\bin\Release folder. |
| 93 | |
| 94 | |
| 95 | [[br]] |
| 96 | === Get the Orxonox source === |
| 97 | Check out the Orxonox-repository from https://svn.orxonox.net/orxonox/trunk/ into a folder named 'trunk', for example 'c:\orxonox\trunk'. It has to be in the same root-folder as your Ogre directory. |
| 98 | * svn co !https://svn.orxonox.net/orxonox/trunk trunk |
| 99 | (Or do it with [http://tortoisesvn.tigris.org TortoiseSVN], the GUI-version of SVN) |
| 100 | |
| 101 | |
| 102 | [[br]] |
| 103 | === CMake === |
| 104 | Now we can build Orxonox. To do so, we need CMake. CMake is a cross-platform system for build automation. Download the latest binary release from [http://cmake.org/HTML/Download.html here] and install it (you can check "Do not add CMake to the system PATH"). |
| 105 | |
| 106 | Create a file with a short name (in this example, we use 'c:\orxonox\trunk\cm') in your trunk-folder with following content: |
| 107 | * [path to your CMake-installation]/bin/cmake . -G "MSYS Makefiles" |
| 108 | |
| 109 | |
| 110 | [[br]] |
| 111 | === Building Orxonox === |
| 112 | Open the MSYS console and type: |
| 113 | 1. ./cm ''(the file we created just before)'' |
| 114 | 2. make |
| 115 | |
| 116 | Now run Orxonox with the 'run-script.bat' file in the 'bin' folder. If you used another directory hierarchy than this tutorial, you'll have to adjust the paths in the .bat file. |