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)