CMake Quick Start Guide         A guide to get you building OGRE from source with the default settings in the shortest possible time
Print

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(external link) 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 the Dependencies repository(external link). To i.e. C:\OgreSDK\Dependencies
  2. Download and install CMake(external link). You want the 'Win32 installer' release in the binary distribution section. Use version +2.8; version 3.x is not widely tested yet.
  3. Launch CMake via Start > Program Files > CMake 2.8 > CMake
  4. Point "Where is the source code" to C:\OgreSDK\Dependencies; and "Where to build the binaries" pointing to "C:\OgreSDK\Dependencies\build"
  5. Click 'Configure' and select the generator (i.e. if you're using Visual Studio 2013, select Visual Studio 12) Image
  6. Answer 'Ok' when asked if you want to create the build directory
  7. Sometimes on bleeding edge repos there might be CMake syntax warnings. Ignore them.
  8. Now click 'Generate'.
  9. Open C:\OgreSDK\Dependencies\build\OGREDEPS.sln under Visual Studio. If you have multiple versions of VS, make sure you open it with the one you targeted for in CMake.
  10. Build the whole solution; which should build FreeImage, freetype, OIS, zlib and zziplib. Make sure to build both Debug and Release
  11. Once it's finished, right click on INSTALL project, and click build. THIS IS VERY IMPORTANT. It will create the folder structure that Ogre needs. You need to do this both for Debug and Release. Image
  12. This should've created an SDK folder structure under C:\OgreSDK\Dependencies\build\ogredeps
  13. Now download Ogre from the repository(external link) into C:\OgreSDK.
  14. We now repeat the same process: Open CMake, set C:\OgreSDK and C:\OgreSDK\build as "Where is the source code" and "Where to build the binaries" respectively.
  15. Hit Configure and choose the same Visual Studio generator you did for the dependencies. It will now complain it can't find the Dependencies.
  16. Set OGRE_DEPENDENCIES_DIR to point to C:\OgreSDK\Dependencies\build\ogredeps as in the picture. Use the search filter to find the option quickly. Now hit configure again. Image
  17. Pro tip: If "C:\OgreSDK\Dependencies" contains the files that are generated in C:\OgreSDK\Dependencies\build\ogredeps; you can skip the previous step.
  18. Click Generate.
  19. Open the solution C:\OgreSDK\build\OGRE.sln and compile.
  20. Right click on INSTALL project if you wish to generate the SDK structure we provide in our official releases.
  21. You're done.
  22. If you are like me (I don't like using INSTALL feature for my own projects), you can add C:\OgreSDK\build\include to your project's include location and C:\OgreSDK\build\lib\Debug (and Release) to your additional library paths. The DLLs will be located in bin\debug (or release)

 
That's it for CMake! You now have a set of project files that are very much like you're used to in previous versions of OGRE, in the output folder you chose. There is now a special target called 'ALL_BUILD' which is a quick way to build all targets for a specific configuration. Note that all build output is now stored in a subfolder of this build folder, and not in the original OGRE source folder - so you can create multiple builds from one source directory now.

If you're more into video tutorials instead of reading, here's one:

Flash player not available.

If the embedded player is not showing up, here's the link: https://www.youtube.com/watch?v=-3XwyYQ9OLg(external link)


Contributors to this page: dark_sylinc1400 points  , xavier69 points  , wolfmanfx398 points  , tp56 points  , Spacegaier6073 points  , sajty75 points  , masterfalcon435 points  , jacmoe180265 points  , holocronweaver3177 points  , Emerich41 points  , ejtttje216 points  , edoardo782 points  , DanielSefton1 points  , Captain Oz46 points  and c6burns837 points  .
Page last modified on Sunday 06 of September, 2015 22:10:44 UTC by dark_sylinc1400 points .


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.