Skip to main content

History: MogreBuilder

Source of version: 11 (current)

Copy to clipboard
            {DIV(class="clearRight")}{img fileId="2124" align="right"}{DIV}

The MogreBuilder is a nice tool to build Mogre automatically. 
It downloads all needed sources, performs the complex wrapping process and build Ogre/Mogre. 

!!Depencies
Before usage you just need to install:
* Microsoft Visual Studio 2010 
** OR alternatively [http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-csharp-express|Visual C# 2010 Express] AND [http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express|Visual C++ 2010 Express] (free)  
* [http://tortoisehg.bitbucket.org/download/index.html|TortoiseHg] 
* [http://www.cmake.org/cmake/resources/software.html|Cmake]
* [http://www.microsoft.com/download/en/details.aspx?id=6812|DirectX SDK (June 2010)]

Note: Some further Ogre depencies will be downloaded automatically. 

!!Step by step
* Download MogreBuilder source and compile ([https://bitbucket.org/mogre/mogrebuilder|download])
* Look to the file ''readMe.txt'' to see which depencies have to be installed %beginsmall%(Can be more than listed on this wiki page)%endsmall%
* Create an empty working directory and set the command line parameter in project properties. e.g. ''C:\Mogre''
* Setup the config file if required. There is a ''Default.cfg'' as an example. 

You can specify a different config file using the command line options:
{CODE()}MogreBuilder.exe C:\Mogre -config myConfig.cfg{CODE}

The auto-builder should now ran successfully.
(Be patient during the repository cloning tasks at the first usage.)

%info% Please give feedback in the MogreBuilder forum topic ([http://www.ogre3d.org/addonforums/viewtopic.php?f=8&t=29272|here]). 
If there are problems, tell it. %beginsmall%(Consider to use the "Snipping Tool" of Windows 7 for easy screenshot creation. Just type "snipp" into the search field of the start menu.)%endsmall%


!!Build Debug version of Mogre
Sometimes it's useful to have a debug version of Mogre. Then you can debug even inside of wrapped C++ Ogre files. 
For this open your MogreBuilder config file (e.g. ''Default.cfg'') and then change the value of "BuildConfiguration" to Debug. 
{CODE(wrap="1", colors="c++")}BuildConfiguration = "Debug";{CODE}

When you use these files for Debugging, keep in mind to update the "plugins.cfg" file.
The name of the plug-ins needs a "_d" prefix. 

Example: 
Change "Plugin_OctreeZone.dll" to "Plugin_OctreeZone___d__.dll"

Additionally it's important to keep all Ogre/Mogre source files on your hard drive. (don't delete them)


!!See also
* [https://bitbucket.org/mogre/mogrebuilder|MogreBuilder repository] - the builder sources
* [http://www.ogre3d.org/addonforums/viewtopic.php?f=8&t=29272|Forum topic] ("[MogreBuilder] My mission to build a better Mogre")
* [http://www.ogre3d.org/addonforums/viewtopic.php?f=8&t=14021|Old forum topic] ("Mogre.Builder - a tool for easy, automatic build of Mogre")
* [https://bitbucket.org/mogre/mogrebuilder/issues?status=new&status=open|Bug tracker] - It's mostly a roadmap for planned or half finished features (including details/links).


MogreBuilder development blog by Zarifus:
* [http://www.craftworkgames.com/blog/building-a-better-mogre-part-1/|Part 1] - Building Amirabiri's command line version
* [http://www.craftworkgames.com/blog/building-a-better-mogre-part-2/|Part 2] - Getting it into the bitbucket repository, taking a look at McDonte's GUI and testing the 
* [http://www.craftworkgames.com/blog/building-a-better-mogre-part-3/|Part 3] - Finishing the command line version, fixing the patch issue, running from a config file (new binaries included)
* [http://www.craftworkgames.com/blog/building-a-better-mogre-part-4/|Part 4] - Including Terrain and Paging, Cygon's improvements and automatic version updating (binaries and samples included)

!!Contribution
Special thanks to:
* __Amirabiri__ - Creator of the MogreBuilder project (started in 2011)
* __McDonte__ - Continued the development (e.g. added a GUI with many options)
* __Zarifus__ - Solved remaining problems, finished the development (in 2012) and added support for terrain/paging component and add-ons
* __((User:Beauty|Beauty))__ - Continued the development (started in March 2012)
* __Caprico__ - Further improvement (e.g. the latest Ogre depencies will be downloaded/compiled by source) (started in June 2012)