Guide for setting up an Ogre application using Visual Studio 2010 (VC10).
Prerequisites
- Visual Studio 2010 must be installed. Express and higher.
- The Ogre SDK version 1.7 or greater must be installed.
- Installing the Ogre SDK: Installing the Ogre SDK
- Build Ogre from source with CMake: CMake Quick Start Guide If you are building Ogre from source, you must build the debug and release targets and execute the Install script for both targets as well. This will create a directory structure that is identical to the binary install structure.
Setting Up an Application for Visual Studio 2010
Environment Variables
Run setx OGRE_HOME path_to_ogre_sdk in a command console (cmd.exe):
Alternatively, create this handy batch script:
setx OGRE_HOME %CD%
pause
Save it as OGRE_HOME.bat and put it in the root directory of the Ogre SDK.
Run it, and the OGRE_HOME environment variable points to that directory.
Handy when you switch between several Ogre SDKs.
New Project
Create a new Win32 project (File -> New -> Project):
Make sure that Windows Application is selected and Empty Project is checked:
Tutorial Framework
Tutorial Framework:
Download the Ogre Wiki Tutorial Framework here:
TutorialFramework.zip
Extract Tutorial Framework:
Add Existing Items to Project:
Select Files:
Project Configuration
Project Properties:
Common Settings
Switching to All Configurations:
General Configuration Properties
Set Character Set to Use Multi-Byte Character Set on the General Configuration Properties page:
Debugging Configuration Properties
Command:
$(OGRE_HOME)\Bin\$(Configuration)\$(ProjectName).exe
Working Directory:
$(OGRE_HOME)\Bin\$(Configuration)
Configuration Properties - C/C++ - General - Additional Include Directories
$(OGRE_HOME)\include
$(OGRE_HOME)\include\OIS
$(OGRE_HOME)\include\OGRE
$(OGRE_HOME)\Samples\Common\include
$(OGRE_HOME)\boost_1_44
Configuration Properties - Linker - General - Additional Library Directories
$(OGRE_HOME)\lib\$(Configuration)
$(OGRE_HOME)\boost_1_44\lib
Configuration Properties - Build Events - Post-Build Event - Command Line
copy "$(OutDir)\$(TargetFileName)" "$(OGRE_HOME)\Bin\$(Configuration)"
Configuration Specific Settings
Switch configuration to "Active(Debug)".
Add input libraries for debug:
Switch configuration from "Active(Debug)" to "Active(Release)".
Add input libraries for release:
That's it!
You've set up an Ogre project succesfully.
All that remains is to build and run it.
Make sure you optimize your build time with Precompiled headers
ogre.cfg
Render System=Direct3D9 Rendering Subsystem
[Direct3D9 Rendering Subsystem]
Allow NVPerfHUD=No
FSAA=0
Floating-point mode=Fastest
Full Screen=No
Rendering Device=NVIDIA GeForce FX 5200
VSync=No
Video Mode=800 x 600 @ 32-bit colour
[OpenGL Rendering Subsystem]
Colour Depth=32
Display Frequency=60
FSAA=0
Full Screen=Yes
RTT Preferred Mode=FBO
VSync=No
Video Mode=1024 x 768
Note: If you hear your graphics card squealing when showing the Ogre head, turn Vsync to "yes" in ogre.cfg! Your graphics card will squeal when there are too many frames per second being rendered.