{DIV(class="achtung")}
__This page is mostly needless for current Mogre versions__, because our new Mogre SDK installer will manage all you need to run Mogre. 
After installation you can build the demo applications of the SDK. 
To learn how Mogre works, you should read and work through the ((Mogre Tutorials|Mogre Basic Tutorials)).
Some useful notes about Mogre trouble shooting and how to create an own VS project you find on ((Mogre Basic Tutorial 0|this page)).
{DIV}

The following notes are mostly obsolete. 
(It's planned to clean up the page in the future.)

{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
{DIV(float="right")}
{SPLIT()}{IMG(src="img/wiki_up/MOGRE_Fresnel_Sample.jpg",thumb="y",button="y",imalign="right", align="right",stylebox="border", rel="box[g]", width="300", title="Mogre Fresnel Sample")}{IMG}
@@@

{IMG(src="img/wiki_up/MOGRE_MogreForm_Sample.jpg",thumb="y",button="y",align="right",stylebox="border",imalign="right",  rel="box[g]", width="300", title="Mogre Form Sample")}{IMG}
@@@
{IMG(src="img/wiki_up/MOGRE_SkeletalAnimation_Sample.jpg",thumb="y",button="y",align="right",stylebox="border", imalign="right", rel="box[g]", width="300", title="Mogre Skeletal Animation Sample")}{IMG}{SPLIT}{DIV}

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''

---
Alias: (alias(MOGRE_Installation))