Qt 5 integration for Ogre 2.1
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Qt 5 integration of Ogre 2.1

You will need a C++11 complient compier. This code was tested with Visual Studio 2015 on Windows, and with GCC 7 on Linux.


The goal is to have multiple viewports of Ogre either running separate or multiple different scenes.

Design idea

  • Initialization of Ogre Root object, and of the HLMS with lifetime tied to a sigle singleton object
  • Integration of Qt window events with Ogre
  • a QOgreViewport widget class containing an Ogre "external render window", but behave as a simple window.
  • Possibility to refresh the viewport at repaint, or at a "user chosen" framerate (30, 60fps)

this project is not intended to render games, but to provide an usefull utility for integrating a 3D view to a desktop application, like an editor

Since Ogre2 is fairly new, some Ogre1->Ogre2 transition facilities have to be in place, like the runtime convertion of v1 .mesh MeshSerializer objects to the new .mesh format.

How to use

Easy integration of Ogre2 into a Qt project via QMake

This small library is suitable to be put inside your project via git submodule

Here's what you need to add to the .pro file of your application. You just need to specify where Ogre is installed, and the relative path between your project and the folder containing the .pri of Qt5Ogre21.

# Path to Ogre SDK. You can use a OGRE_HOME env var if you want. Check QMake documentation about environement variables
OGRE21SDK = "C:\YbalridSoftware\Ogre21\build\sdk"

#Path to where the QtOgre project files are. You can use $PWD to get the path of the folder of this .pro
QTOGRE = $${PWD}/../external/Qt5Ogre21/Qt5Ogre21/

#The magic include

What to do in your code

Create an instance of the QtOgre21 object along side your QApplication. If you don't you can't create QOgreViewport widgets.

The QtOgre21 constructor takes 2 arguments :

  • The rendering API to use, currently OpenGL or D3D11
  • The location of the HLMS library you are using. By defautl it's ./HLMS, meaning that you need to copy the Hlms folder from your ogre sdk there. Only "FileSystem" HLMS libs are supported right now, and it will try to load the PBS and the Unlit ones from the sample. If you're using a custom HLMS, you probably know how to load it and you can go and add that to the code of QtOgre21::declareHlms()

This object is a singleton class, you can access it via calling QtOgre21::instance()

Use QOgreViewport widgets as any other widget in Qt. You can have different scenes. Creating a new scene is done via the QtOgre21 object.

If you want to do that in your main() it would look a little like this:

int main(int argc, char *argv[])
    //Initialize the Qt Application
    QApplication a(argc, argv);

    //Initialize the QtOgre system
    QtOgre21 qtOgre(QtOgre21::RenderAPI::OpenGL);
    //Here you can create widget with viewports (this is actually needed for initializing the rendering API) 
    //and .show() them!
    //Resource locations
    Ogre::ResourceGroupManager::getSingleton().addResourceLocation(".", "FileSystem");

    //HighLevelMaterialSystem shader libraries

    //Initialize the resources
    //get the scene manager
    auto scene = qtOgre.getScene(0);
    //here you can do whatever you would do with an Ogre::SceneManager
    return a.exec()

More explicitely: When creating a first QOgreViewport the 1st time, Ogre will finish the RenderSystem intialization, because it needs a "window" object existing to setup the rendering pipeline. (For Ogre it's "a window" but for you it's just a Qt widget.)

Also, when doing that, it will create a first scene manager that will serve as the default one.

An additional scene can be created when calling QtOgre21::instance()->createNewScene();. QtOgre21 store them as an array, and you will be able to get the scene by their index.

The default scene is index 0, the 1st additional one is 1, etc...

When calling the QOgreViewport constructor, you can specify a "scene manager index" as an argument, when doing this, it will render that scene.

A viewport is automatically attached to a camera via an Ogre2.1 "basic" compositor, and ready to render. I'm planning to add a way to specify a compositor to use, but it's not done yet. For now this is suitable for all your classic rendering needs without post-processing (Donw worry, Anti Aliasing is supported)

Viewports have 2 important methods for you : getCamera() and getSmgr(). Everything esle is usable as any Ogre feature. For everything else, they behave just like bare QWidgets.