Ignition Rendering

API Reference

6.3.1

#include <OgreRenderEngine.hh>

Public Types

enum  OgreRenderPathType {
  NONE = 0, VERTEX = 1, FORWARD = 2, DEFERRED = 3,
  RENDER_PATH_COUNT
}
 The type of rendering path used by the rendering engine. More...
 

Public Member Functions

virtual ~OgreRenderEngine ()
 
void AddResourcePath (const std::string &_uri) override
 Add path to media resource location. More...
 
std::string CreateRenderWindow (const std::string &_handle, const unsigned int _width, const unsigned int _height, const double _ratio, const unsigned int _antiAliasing)
 
virtual void Destroy () override
 Destroys all scenes created by render-engine and releases all loaded resources. This should be called when the given render-engine will no longer be used during runtime. More...
 
std::vector< unsigned int > FSAALevels () const
 Get a list of all supported FSAA levels for this render system. More...
 
virtual bool IsEnabled () const override
 Determines if the render-engine can be used. Despite loading and initializing the render-engine, it may not be possible to use due to hardware capabilities of the runtime system. More...
 
virtual std::string Name () const override
 Get name of the render-engine. More...
 
virtual Ogre::Root * OgreRoot () const
 
OgreRenderPathType RenderPathType () const
 
- Public Member Functions inherited from BaseRenderEngine
virtual ~BaseRenderEngine ()
 
virtual ScenePtr CreateScene (const std::string &_name) override
 Create a new scene with the given name. The given name should be unique across all scenes managed by this render-engine. If a duplicate name is given, NULL will be returned. An unique ID will automatically be assigned to the created scene. More...
 
virtual ScenePtr CreateScene (unsigned int _id, const std::string &_name) override
 Create a new scene with the given ID. The given ID should be unique across all scenes managed by this render-engine. If a duplicate ID is given, NULL will be returned. An unique name will automatically be assigned to the created scene. More...
 
virtual void DestroyScene (ScenePtr _scene) override
 Destroy the given scene. If the given scene is not managed by this render-engine, no work will be done. More...
 
virtual void DestroySceneById (unsigned int _id) override
 Destroy the scene with the given ID. If no scenes exist with the given ID, no work will be done. More...
 
virtual void DestroySceneByIndex (unsigned int _index) override
 Destroy the scene at the given index. If no scenes exist at the given index, no work will be done. More...
 
virtual void DestroySceneByName (const std::string &_name) override
 Destroy the scene with the given name. If no scenes exist with the given name, no work will be done. More...
 
virtual void DestroyScenes () override
 Destroy all scenes managed by this render-engine. More...
 
virtual bool Fini () override
 
virtual bool HasScene (ConstScenePtr _scene) const override
 Determine if the given scene is actively managed by this render-engine. More...
 
virtual bool HasSceneId (unsigned int _id) const override
 Determine if this render-engine manages a scene with the given ID. More...
 
virtual bool HasSceneName (const std::string &_name) const override
 Determine if this render-engine manages a scene with the given name. More...
 
virtual bool Headless () const override
 Get headless mode. More...
 
virtual bool Init () override
 Initialize the render-engine. This should be called immediately after a successful call to Load. More...
 
virtual bool IsInitialized () const override
 Determines if the render-engine has been initialized. More...
 
virtual bool IsLoaded () const override
 Determines if the render-engine has been loaded. More...
 
virtual bool Load (const std::map< std::string, std::string > &_params={}) override
 Load any necessary resources to set up render-engine. This should called before any other function. More...
 
virtual RenderPassSystemPtr RenderPassSystem () const override
 Get the render pass system for this engine. More...
 
virtual ScenePtr SceneById (unsigned int _id) const override
 Get the scene with the given ID. If no scenes exist with the given ID, NULL will be returned. More...
 
virtual ScenePtr SceneByIndex (unsigned int _index) const override
 Get the scene at the given index. If no scenes exist at the given index, NULL will be returned. More...
 
virtual ScenePtr SceneByName (const std::string &_name) const override
 Get the scene with the given name. If no scenes exist with the given name, NULL will be returned. More...
 
virtual unsigned int SceneCount () const override
 Get the number of scenes actively managed by this render-engine. More...
 
virtual void SetHeadless (bool _headless) override
 Set headless mode Only available in OGRE 2.2, which makes use of EGL. More...
 
- Public Member Functions inherited from RenderEngine
virtual ~RenderEngine ()
 Destructor. More...
 

Protected Member Functions

virtual ScenePtr CreateSceneImpl (unsigned int _id, const std::string &_name) override
 
virtual bool InitImpl () override
 
virtual bool LoadImpl (const std::map< std::string, std::string > &_params) override
 Engine implementation of Load function. More...
 
virtual SceneStorePtr Scenes () const override
 
- Protected Member Functions inherited from BaseRenderEngine
 BaseRenderEngine ()
 
virtual unsigned int NextSceneId ()
 
virtual void PrepareScene (ScenePtr _scene)
 
- Protected Member Functions inherited from SingletonT< OgreRenderEngine >
 SingletonT ()
 
virtual ~SingletonT ()
 

Additional Inherited Members

- Static Public Member Functions inherited from SingletonT< OgreRenderEngine >
static OgreRenderEngine * Instance ()
 
- Protected Attributes inherited from BaseRenderEngine
bool initialized = false
 
bool isHeadless = false
 
bool loaded = false
 
unsigned int nextSceneId
 
RenderPassSystemPtr renderPassSystem
 Render pass system for this render engine. More...
 
std::vector< std::stringresourcePaths
 a list of paths that render engines use to locate their resources More...
 
std::string winID = ""
 ID from a external window. More...
 

Member Enumeration Documentation

◆ OgreRenderPathType

The type of rendering path used by the rendering engine.

Enumerator
NONE 

No rendering is done.

VERTEX 

Most basic rendering, with least fidelity.

FORWARD 

Utilizes the RTT shader system.

DEFERRED 

Utilizes deferred rendering. Best fidelity.

RENDER_PATH_COUNT 

Count of the rendering path enums.

Constructor & Destructor Documentation

◆ ~OgreRenderEngine()

virtual ~OgreRenderEngine ( )
virtual

Member Function Documentation

◆ AddResourcePath()

void AddResourcePath ( const std::string _path)
overridevirtual

Add path to media resource location.

Parameters
[in]_pathAbsolute path to resource location

Reimplemented from BaseRenderEngine.

◆ CreateRenderWindow()

std::string CreateRenderWindow ( const std::string _handle,
const unsigned int  _width,
const unsigned int  _height,
const double  _ratio,
const unsigned int  _antiAliasing 
)

◆ CreateSceneImpl()

virtual ScenePtr CreateSceneImpl ( unsigned int  _id,
const std::string _name 
)
overrideprotectedvirtual

Implements BaseRenderEngine.

◆ Destroy()

virtual void Destroy ( )
overridevirtual

Destroys all scenes created by render-engine and releases all loaded resources. This should be called when the given render-engine will no longer be used during runtime.

Returns
True if the render-engine was successfully destroyed

Reimplemented from BaseRenderEngine.

◆ FSAALevels()

std::vector<unsigned int> FSAALevels ( ) const

Get a list of all supported FSAA levels for this render system.

Returns
a list of FSAA levels

◆ InitImpl()

virtual bool InitImpl ( )
overrideprotectedvirtual

Implements BaseRenderEngine.

◆ IsEnabled()

virtual bool IsEnabled ( ) const
overridevirtual

Determines if the render-engine can be used. Despite loading and initializing the render-engine, it may not be possible to use due to hardware capabilities of the runtime system.

Returns
True if the render-engine can be used

Reimplemented from BaseRenderEngine.

◆ LoadImpl()

virtual bool LoadImpl ( const std::map< std::string, std::string > &  _params)
overrideprotectedvirtual

Engine implementation of Load function.

Parameters
[in]_paramsParameters to be passed to the render engine. Current accepts the following parameters and values: "useCurrentGLContext" : "1" or "0". Use current OpenGL context for rendering

Implements BaseRenderEngine.

◆ Name()

virtual std::string Name ( ) const
overridevirtual

Get name of the render-engine.

Returns
The render-engine name

Implements RenderEngine.

◆ OgreRoot()

virtual Ogre::Root* OgreRoot ( ) const
virtual

◆ RenderPathType()

OgreRenderPathType RenderPathType ( ) const

◆ Scenes()

virtual SceneStorePtr Scenes ( ) const
overrideprotectedvirtual

Implements BaseRenderEngine.


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