Installing the Ogre SDK         The necessary steps you need to take to install the precompiled OGRE SDK
IMPORTANT: These instructions are meant to be used with old releases of Ogre. For Ogre 1.10+, rather use BuildingOgre.md.

66px-Vista-synaptic.png
This details the necessary steps you need to take to install the precompiled OGRE SDK.
If you want to build Ogre from source instead, visit the Building Ogre page.


{VERSIONS(nav="y",title="y",default="Microsoft Windows")}

Prerequisites:

  1. Go to http://www.ogre3d.org/download/sdk. (There are also more recent SDK's made available by the forum user Transporter)
  2. Download the SDK matching your IDE version.
  3. Download and install DirectX: directx_Jun2010_redist.exe

Run the installer:

installSDK1.png

Unpack to a suitable location:

installSDK2.png

Go to the directory of the newly installed sdk and copy the full path:

installSDK3.png

Setting the Environment Variable, OGRE_HOME.

Now, you need to set the %OGRE_HOME% environment variable. This environment variable enables you, the developer, to easily switch between different OgreSDK versions and transfer/compile Ogre3D projects of other users (portability).

To set this environment variable, enter the following in any Command Prompt window (Windows Vista/7/8/newer):

setx OGRE_HOME "<path-to-OgreSDK-here>"

If you are using Windows XP, or any prior Windows version, you will need to use the 'set' command, like so:

set OGRE_HOME="<path-to-OgreSDK-here>"

Take note of the use of quotation marks, as they are required, otherwise you will get several 'file not found' errors when trying to compile any Ogre3D project.

Example 1: Setting the environment variable OGRE_HOME on Windows 8:
<img src="http://www.ogre3d.org/tikiwiki/tiki-download_wiki_attachment.php?attId=167&page=Installing%20the%20Ogre%20SDK" />

Example 2: Setting the environment variable OGRE_HOME on Windows 7:
Go to Control Panel -> System and Security -> System. From the left navigation panel choose Advanced system settings.
Click on Environmental varable button and enter in the fields
Variable name: OGRE_HOME and in
Variable value: your path to Ogre example: C:\OgreSDK\OgreSDK_vc10_v1-8-1
Ogre environmental varaiables

That's it. :-)



Open the solution Ogre.sln with Visual Studio and build the project(could take a few minutes). Then Right click on sampleBrowser and choose: ‘Set as startup Project’.
RUN SampleBrowser and you can explore all the samples that are included with the Ogre Solution.
Set the project as startup Project


-(Linux)-
Image
This section is for developers willing to install a precompiled Software Development Kit (SDK) under Linux platform.

Unix users typically compile their own sources for almost all software, including Ogre.

However pre-built binaries are available for a handful of distributions. See below for yours.

Ubuntu

{DIV()}Image

Ubuntu 11.10 (Quantal) and Newer


The Ogre3D libraries are part of the Universe repository, so to download simply install the libogre-dev package via your favorite package manager. For Ubuntu 14.4 there is no libogre-dev, so to install Ogre 1.9 you need to install libogre-1.9-dev.

For example, to install via the terminal enter:

  • sudo apt-get install libogre-1.9-dev


-(Mac OS X)-

Image

This section is for developers willing to install a precompiled Software Development Kit (SDK) under Mac OS X platform.

Once you have OGRE downloaded and setup, learn how to setup your first application.

  1. Go to http://www.ogre3d.org and click on Download.
  2. Next click on Download a Prebuilt SDK.
  3. Download the latest OSX SDK.
  4. Double-click the .dmg to mount it
  5. Drag & drop the OgreSDK folder wherever you like to install the SDK
  6. Install CMake for building the samples. Version 2.8.0 is said to be the most stable version for this. Cmake v2.8 (if you have a MacPorts installation of cmake, read the section below.)
  7. You might need this as well CG Toolkit (the download is only available for registered members of Nvidia Developer Zone. You may create your own account or use one of those BugMeNot)
  8. Start up Xcode and load the OgreSDK/OGRE.xcodeproj to build the samples. You probably want to build the debug versions of these. It will give you more insight when things go wrong. Make sure you select that from the build type dropdown.
  9. After you have built the samples look for them in OgreSDK/bin/debug. You should see SampleBrowser.app in there. Fire it up!

Cmake over MacPorts

If you have installed Cmake over MacPorts, you need to do some replacement inside CMakeScripts/ReRunCMake.make:

  • replace /Applications/CMake\ 2.8-5.app/Contents/share/cmake-2.8/Modules/ by /opt/local/share/cmake-2.8/Modules/
  • replace /Applications/CMake\ 2.8-5.app/Contents/bin/cmake by /opt/local/bin/cmake


{VERSIONS}

Next Step:

Now you are ready to go to Setting Up an Application, and/or visit the Tutorials.




Alias: Installing An SDK
Alias: Installing_An_SDK
Alias: Installing_the_Ogre_SDK_on_Mac_OS_X