An Ogre3D 1.9 and C++ project template that uses cmake to generate project files.
You can fork this repo and work on the files in the source directory.
Building your Project
- Linux using a Makefile or Eclipse
- Windows using Visual Studio
- Any platform using Vagrant and a Linux Virtual Machine
In order to use the optional additional libraries below, you must make sure this repo's submodules have been cloned. Run this command in the repo directory:
git submodule init && git submodule update --remote --merge
You can append more than one of these options to get any combination of additional libraries.
Building Your Project
GNU Make (Linux)
Check the building OGRE from source section if anything fails here.
First, clone the repo (or fork it!):
git clone https://github.com/matthewjberger/eager
Then to build, use CMake:
cd eager mkdir build cd build # To generate makefiles and build cmake .. make # Alternatively, to generate an eclipse project cmake -G "Eclipse CDT4 - Unix Makefiles" -D CMAKE_BUILD_TYPE=Debug ..
This will generate a makefile in the
You can open this folder as a project in eclipse if you generated eclipse project files, using the following instructions from the cmake wiki:
To import the created project file into Eclipse:
1.) Import project using Menu File->Import 2.) Select General->Existing projects into workspace: 3.) Browse where your build tree is and select the root build tree directory. Keep "Copy projects into workspace" unchecked. 4.) You get a fully functional eclipse project
Finally, when you compile, your project can be found in the
Windows with Visual Studio 2015
First, clone or fork this repo, and then:
Visual Studio 2012 express:
Visual Studio 2015 Community:
4.) Download the
OGRE SDK for
Visual Studio 2012:
5.) Run the
Ogre SDK executable to extract the
Ogre SDK to a directory on your computer.
6.) Set an environment variable named
OGRE_HOME to the root path of the extracted SDK folder
7.) Create a directory named
build inside the root of your clone of this repository.
8.) Generate a
Visual Studio 2015 solution and project files:
cmake -G "Visual Studio 14 2015" -T v110 ..
9.) Open the solution located in the
- There will be a prompt asking you to 'upgrade' your project. You should hit cancel on this dialog, as we don't want to upgrade.
10.) Finally, when you run your program make sure you choose
DirectX 9 or
OpenGL as your renderer backend.
Precompiled Headers, which can speed up the build time significantly.Note: Consider using
This will generate an ubuntu virtual machine with eclipse, cmake, and the Ogre3D library built from source and installed.
After loading up this virtual machine, you can follow the build instructions above for working on your project.
1.) Install Vagrant
3.) Clone this repo with:
git clone https://github.com/matthewjberger/eager cd eager
4.) Enter the following command:
The virtual machine will be downloaded and then opened in VirtualBox. You can login with the password
vagrant. The files in this repo are in the folder
~/Code/eager which is also shared with the host.
Note: If there is an issue with the mouse while running a 3D program that captures the mouse, hit
ctrl+home and then go to
input->mouse integration and disable it. This can be re-enabled when you're finished running the program.
Building OGRE from Source
Note: If you're using the ecc computers at the University of Nevada, Reno, the following steps are not required. The library has already been built from source and installed. However, if you are using NoMachine the code will compile but to run you must use the command below:
/usr/NX/scripts/vgl/vglrun <your project's .bin path here>
Ogre 3D must be installed. If it isn't installed you should build it from the source with the following commands. Mercurial is required to clone the repo.
Ubuntu (or any Debian-Based Linux distribution)
Download the required dependencies:
sudo apt-get install libfreetype6-dev libfreeimage-dev libzzip-dev libxrandr-dev libxaw7-dev freeglut3-dev libgl1-mesa-dev libglu1-mesa-dev libcppunit-dev libboost-thread-dev libois-dev mercurial cmake g++ gdb doxygen
Clone the repo and grab version 1.9:
hg clone https://bitbucket.org/sinbad/ogre cd ogre hg pull hg update v1-9
Use cmake to generate a makefile:
mkdir build cd build cmake ..
Install the library:
sudo make install
-DINCLUDE_BULLET=ON when you generate your project file with cmake:
# Make cmake .. -DINCLUDE_BULLET=ON # Eclipse cmake -G "Eclipse CDT4 - Unix Makefiles" -D CMAKE_BUILD_TYPE=Debug .. -DINCLUDE_BULLET=ON # Visual Studio 2015 cmake -G "Visual Studio 14 2015" -T v110 .. -DINCLUDE_BULLET=ON