CMake Quick Start Guide         A guide to get you building OGRE from source with the default settings in the shortest possible time
IMPORTANT: These instructions are meant to be used with old releases of Ogre. For Ogre 1.10+, rather use BuildingOgre.md.
Image

For the impatient: Learn how to build Ogre with CMake in two minutes. If you encounter any problems or need some more advanced procedures, do read the rest of the sections below!

Introduction

This guide is designed to get you building OGRE from source with the default settings in the shortest possible time, showing you the barest minimum of CMake to do that, and minus any real discussion. Remember that there is a lot more to the hows and whys of this process, so it's a good idea to go back to the Getting Started With CMake page and read the whole thing when you have time.

We assume here that you've already downloaded / extracted the OGRE source code into a folder on your local machine. From here, go to the section for your platform.

Done Make sure that you've sorted out the Prerequisites before attempting to build Ogre with CMake!

  1. Download Ogre Source (Instructions below assume current version of 1.8.0, update as needed)
  2. Decompress:
    tar xjf ogre_src_v1-8-0.tar.bz2
  3. Move to source directory:
    cd ogre_src_v1-8-0
  4. Create build directory:
    mkdir build
  5. Move into build directory:
    cd build
  6. Trigger cmake, passing path to Ogre source directory:
    cmake ..
    See the Extensive CMake page for a list of compilation options which can be passed to CMake at this stage, and Getting Started With CMake for even more background material. N.B. Please note that OGRE_CONFIG_THREADS = 1 is not supported on Linux.
  7. If the CMake results look good, build Ogre:
    make -j2
    The -j2 specifies how many parallel compilation jobs to run. Substitute the number of processor cores on your system, e.g. -j2 for a dual-core, -j4 for a quad core...
  8. Once compilation is successful, you can install into the system (by default, /usr/local):
    sudo make install