OGRE  master
Object-Oriented Graphics Rendering Engine
OgreBites::ApplicationContextQt Class Reference

Specialization for connecting with Qt. More...

#include <OgreApplicationContextQt.h>

+ Inheritance diagram for OgreBites::ApplicationContextQt:

Public Member Functions

 ApplicationContextQt (const Ogre::String &appName="Ogre3D")
 
void addInputListener (NativeWindowType *win, InputListener *lis) override
 attach input listener More...
 
NativeWindowPair createWindow (const Ogre::String &name, uint32_t w=0, uint32_t h=0, Ogre::NameValuePairList miscParams=Ogre::NameValuePairList()) override
 Create a new render window. More...
 
NativeWindowPair createWindow (QWindow *window, Ogre::NameValuePairList miscParams=Ogre::NameValuePairList())
 
void injectMainWindow (QWindow *window)
 allows overriding the main (first) Window with a pre-created QWindow More...
 
void pollEvents () override
 process all window events since last call More...
 
void removeInputListener (NativeWindowType *win, InputListener *lis) override
 detatch input listener More...
 
void setWindowGrab (NativeWindowType *win, bool grab) override
 When input is grabbed the mouse is confined to the window. More...
 
void shutdown () override
 Cleans up and shuts down the context. More...
 
void useQtEventLoop (bool enable)
 signal that you want to use the Qt event loop More...
 
- Public Member Functions inherited from OgreBites::ApplicationContextBase
 ApplicationContextBase (const Ogre::String &appName="Ogre3D")
 
virtual ~ApplicationContextBase ()
 
void _fireInputEvent (const Event &event, uint32_t windowID) const
 inspect the event and call one of the corresponding functions on the registered InputListener More...
 
void addInputListener (InputListener *lis)
 
void closeApp ()
 This function closes down the application - saves the configuration then shutdowns. More...
 
void createDummyScene ()
 Creates dummy scene to allow rendering GUI in viewport. More...
 
virtual void createRoot ()
 Creates the OGRE root. More...
 
void destroyDummyScene ()
 Destroys dummy scene. More...
 
void destroyRTShaderSystem ()
 Destroy the RT Shader system. More...
 
void destroyWindow (const Ogre::String &name)
 destroy and erase an NativeWindowPair by name More...
 
void enableShaderCache () const
 enables the caching of compiled shaders to file More...
 
bool frameEnded (const Ogre::FrameEvent &evt) override
 Called just after a frame has been rendered. More...
 
bool frameRenderingQueued (const Ogre::FrameEvent &evt) override
 Called after all render targets have had their rendering commands issued, but before render windows have been asked to flip their buffers over. More...
 
bool frameStarted (const Ogre::FrameEvent &evt) override
 Called when a frame is about to begin rendering. More...
 
virtual float getDisplayDPI () const
 get the vertical DPI of the display More...
 
Ogre::FileSystemLayergetFSLayer () const
 get the FileSystemLayer instance pointing to an application specific directory More...
 
InputListenergetImGuiInputListener () const
 
Ogre::OverlaySystemgetOverlaySystem () const
 
Ogre::RenderWindowgetRenderWindow () const
 get the main RenderWindow owns the context on OpenGL More...
 
Ogre::RootgetRoot () const
 
void initApp ()
 This function initializes the render system and resources. More...
 
Ogre::ImGuiOverlayinitialiseImGui ()
 Set up the overlay system for usage with ImGui. More...
 
bool initialiseRTShaderSystem ()
 Initialize the RT Shader system. More...
 
virtual void loadResources ()
 Loads context-wide resource groups. More...
 
virtual void locateResources ()
 Finds context-wide resource groups. More...
 
virtual bool oneTimeConfig ()
 Configures the startup settings for OGRE. More...
 
void reconfigure (const Ogre::String &renderer, Ogre::NameValuePairList &options)
 
void removeInputListener (InputListener *lis)
 
void runRenderingSettingsDialog ()
 Show the renderer configuration menu. More...
 
void setRTSSWriteShadersToDisk (bool write)
 make the RTSS write out the generated shaders for caching and debugging More...
 
virtual void setup ()
 Sets up the context after configuration. More...
 
void setWindowGrab (bool grab=true)
 
virtual void windowClosed (Ogre::RenderWindow *rw)
 
virtual bool windowClosing (Ogre::RenderWindow *rw)
 
virtual void windowFocusChange (Ogre::RenderWindow *rw)
 
virtual void windowMoved (Ogre::RenderWindow *rw)
 
virtual void windowResized (Ogre::RenderWindow *rw)
 
- Public Member Functions inherited from Ogre::FrameListener
virtual ~FrameListener ()
 

Additional Inherited Members

- Static Public Member Functions inherited from OgreBites::ApplicationContextBase
static Ogre::String getDefaultMediaDir ()
 the directory where the media files were installed More...
 

Detailed Description

Specialization for connecting with Qt.

  • Set a QBasicTimer on this or call startTimer() to update all associated windows using Root::renderOneFrame.
  • Use the QWindow::requestUpdate() slot to refresh a single Window using RenderWindow::update
  • QWidget::createWindowContainer and QWidget::windowHandle() provide translation between QWidget and QWindow

Assumes that Ogre Main loop is used for compatibility with other implementations.

Constructor & Destructor Documentation

◆ ApplicationContextQt()

OgreBites::ApplicationContextQt::ApplicationContextQt ( const Ogre::String appName = "Ogre3D")
inlineexplicit

Member Function Documentation

◆ createWindow() [1/2]

NativeWindowPair OgreBites::ApplicationContextQt::createWindow ( const Ogre::String name,
uint32_t  w = 0,
uint32_t  h = 0,
Ogre::NameValuePairList  miscParams = Ogre::NameValuePairList() 
)
overridevirtual

Create a new render window.

You must use SDL and not an auto-created window as SDL does not get the events otherwise.

By default the values from ogre.cfg are used for w, h and miscParams.

Reimplemented from OgreBites::ApplicationContextBase.

◆ createWindow() [2/2]

NativeWindowPair OgreBites::ApplicationContextQt::createWindow ( QWindow *  window,
Ogre::NameValuePairList  miscParams = Ogre::NameValuePairList() 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ injectMainWindow()

void OgreBites::ApplicationContextQt::injectMainWindow ( QWindow *  window)
inline

allows overriding the main (first) Window with a pre-created QWindow

Parameters
window

References OgreAssert.

◆ useQtEventLoop()

void OgreBites::ApplicationContextQt::useQtEventLoop ( bool  enable)
inline

signal that you want to use the Qt event loop

aka QApplication::exec() instead of Root::startRendering. In this case you may want to call startTimer on this QObject which ensures that Root::renderOneFrame is called periodically.

Parameters
enable

References OgreBites::ApplicationContextBase::addInputListener(), OgreBites::ApplicationContextBase::removeInputListener(), and OgreBites::ApplicationContextBase::setWindowGrab().

◆ setWindowGrab()

void OgreBites::ApplicationContextQt::setWindowGrab ( NativeWindowType win,
bool  grab 
)
overridevirtual

When input is grabbed the mouse is confined to the window.

Reimplemented from OgreBites::ApplicationContextBase.

◆ addInputListener()

void OgreBites::ApplicationContextQt::addInputListener ( NativeWindowType win,
InputListener lis 
)
overridevirtual

attach input listener

Parameters
listhe listener
winthe window to receive the events for.

Reimplemented from OgreBites::ApplicationContextBase.

◆ removeInputListener()

void OgreBites::ApplicationContextQt::removeInputListener ( NativeWindowType win,
InputListener lis 
)
overridevirtual

detatch input listener

Parameters
listhe listener
winthe window to receive the events for.

Reimplemented from OgreBites::ApplicationContextBase.

◆ pollEvents()

void OgreBites::ApplicationContextQt::pollEvents ( )
overridevirtual

process all window events since last call

Reimplemented from OgreBites::ApplicationContextBase.

◆ shutdown()

void OgreBites::ApplicationContextQt::shutdown ( )
overridevirtual

Cleans up and shuts down the context.

Reimplemented from OgreBites::ApplicationContextBase.


The documentation for this class was generated from the following file: