History: MOGRE Installation
Source of version: 5
Copy to clipboard
{DIV(type="div",float="right", class="todo_box")}
__Todo__ on this page:
* update to current Mogre release
* update depencies + links ([http://www.ogre3d.org/addonforums/viewtopic.php?t=7274|thread])
* differentiation of depencies for using ''release'' and ''debug'' library
(with explanation what of is the difference)
* Some informations are redundant here and in ((Mogre Basic Tutorial 0))
Maybe merge or remove them?
--((User:Beauty|Beauty)){DIV}
{maketoc showhide="y"}
!!Download and Installation
Download and install the latest prebuilt SDK from [http://downloads.sourceforge.net/mogre/MOgreSDKSetup1.4.6_VC80.exe?modtime=1199035549&big_mirror=0|MOGRE 1.4.6 SDK installer]
(''for previous releases use [http://sourceforge.net/project/showfiles.php?group_id=174997|MOGRE SourceForge file releases]'')
MOGRE is built using Visual Studio 8 SP1, so it requires the VC SP1 libraries. You either have to install the [http://msdn2.microsoft.com/en-us/vstudio/bb265237.aspx|SP1 for your IDE] (Visual Studio, [http://www.microsoft.com/express/vcsharp|Visual C# Express], etc.) or just [http://downloads.sourceforge.net/mogre/vcredist_x86.exe|install the SP1 vcredist_x86].
__Notes:__
* If you install only [http://www.microsoft.com/downloads/details.aspx?familyid=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=de|vcredist_x86], you'll be able to use only the Release binaries of Mogre. Read [http://www.ogre3d.org/phpBB2addons/viewtopic.php?p=23666#23666|this post] for information on how to get the debug binaries working on your development machine)
* If you decide for Visual Studio SP1: Install the SP1 of version 2005 even if you use Visual Studio 2008
* To use the Direct3D9-Renderer you need to install the [http://www.microsoft.com/downloads/details.aspx?FamilyId=1A2393C0-1B2F-428E-BD79-02DF977D17B8&displaylang=en|DirectX Redistributables from November 2007] or newer
MOGRE comes with several new files compared to the original OGRE:
* __\bin\debug\Mogre.dll__ and __\bin\release\Mogre.dll__ - main DLLs for MOGRE
* __\bin\debug\MogreNewt.dll__ and __\bin\release\MogreNewt.dll__ - DLLs for ((MogreNewt)) physics engine
* __\Mogre-Samples\__ - Sample files for running MOGRE (includes ExampleApplication)
{DIV(bg="#CAFEDB")}A good __summary__ what to do is __in ((The zero knowledge guide to making a game##Setting it all up|this article))__.
A very useful __detailed tutorial__ how to setup: __((Mogre Basic Tutorial 0))__{DIV}
!!Updating
* Don't forget to copy the new DLLs to your output directory (__bin\release__ or __bin\debug__), otherwise you will get some strange exceptions!
* Maybe you also need to update __bin\debug\Plugins.cfg__ (if the file name of some refered debug libraries changed).
!!Running Sample Applications
{img src="img/wiki_up/MOGRE_Fresnel_Sample.jpg" alt="thumbnail=MOGRE_Fresnel_Sample_thumb.jpg|MOGRE Fresnel Sample"}
{IMG(src="img/wiki_up/MOGRE_MogreForm_Sample.jpg",thumb="y",button="y",align="right",stylebox="border")}{IMG}
{img src="img/wiki_up/MOGRE_SkeletalAnimation_Sample.jpg" alt="thumbnail=MOGRE_SkeletalAnimation_Sample_thumb.jpg|MOGRE SkeletalAnimation Sample"}
MOGRE comes with some sample applications
* __Fresnel__ - pool with water and fishes (port of OGRE's Fresnel demo)
* __MogreForm__ - simple app demonstrating how to render on a Windows Form
* __SkeletalAnimation__ - ten walking robots (port of OGRE's older SkeletalAnimation demo)
* __VB.NET SkeletalAnimation__ - The SkeletalAnimation demo ported to VB.NET
* __Gui__ - uses ((OgreDotNet))'s ((CEGUI)) bindings for a ((GUI)) sample (port of OGRE's Gui demo)
* __Dot3Bump__ - port of Ogre's Dot3Bump demo
* ''(NOTE: __ExampleApplication__ is the base DLL for the other samples)''
# Open __\OgreSDK\Mogre-Samples\Samples.sln__
# Batch build all the samples. The sample executables are copied to __\OgreSDK\bin\debug\__ or __\OgreSDK\bin\release\__
# Either execute the samples directly from the __\OgreSDK\bin\__ folders or if you want to run a sample through Visual Studio:
## Open the __Properties__ page of the sample project
## View the __Debug__ tab
## Select __Start external program__ and enter the path of the sample executable (e.g. __C:\OgreSDK\bin\debug\Mogre.Demo.Fresnel.exe__)
## Enter the folder path in the __Working directory__ (e.g. __C:\OgreSDK\bin\debug\__)
## Select __Set as StartUp Project__
## Start compiling!
!!Setup MOGRE for own application
# Create new solution as "console application"
# Add reference to __Mogre.dll__ of __\OgreSDK\bin\__ (__release\__ or __debug\__)
# ''OPTIONAL: Beginners may also add __Mogre.Demo.ExampleApplication.dll__ and access it via ''using Mogre.Demo.ExampleApplication;''''
# Open the __Properties__ page of your application's project
# View the __Build Events__ tab
# In the __Post-build event command line__ enter:
{CODE()}copy "$(TargetPath)" "%OGRE_HOME%\bin\$(ConfigurationName)"{CODE}
# To run your application do step 3 of ((MOGRE Installation##Running Sample Applications|Running Sample Applications))
# ''OPTIONAL: If you don't want to conflict project specific files (e.g. plugins.cfg) with other projects, set the __Working directory__ to something different and put the files there''