If you haven't done so already, be sure to visit the Wiki Portal to read about how the wiki works. Especially the Ogre Wiki Overview page.
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 Basic Tutorials.
Some useful notes about Mogre trouble shooting and how to create an own VS project you find on this page.
The following notes are mostly obsolete.
(It's planned to clean up the page in the future.)
Table of contents
Download and Installation
Download and install the latest prebuilt SDK from MOGRE 1.4.6 SDK installer
(for previous releases use 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 SP1 for your IDE (Visual Studio, Visual C# Express, etc.) or just install the SP1 vcredist_x86.
- If you install only vcredist_x86, you'll be able to use only the Release binaries of Mogre. Read 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 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)
A very useful detailed tutorial how to setup: Mogre Basic Tutorial 0
- 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
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:
copy "$(TargetPath)" "%OGRE_HOME%\bin\$(ConfigurationName)"
- To run your application do step 3 of 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
The content on this page is licensed under the terms of the Creative Commons Attribution-ShareAlike License.
As an exception, any source code contributed within the content is released into the Public Domain.