#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 rendering::GraphicsAPI	GraphicsAPI () const override
	Returns the GraphicsAPI currently in use. 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...

Static Public Member Functions
static OgreRenderEngine *	Instance ()
	Get a pointer to the render engine. More...

Static Public Member Functions inherited from SingletonT< OgreRenderEngine >
static T *	Instance ()

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
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::string >	resourcePaths
	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

enum 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] _path Absolute 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

◆ GraphicsAPI()

virtual rendering::GraphicsAPI GraphicsAPI ( ) const

overridevirtual

Returns the GraphicsAPI currently in use.

Returns: GraphicsAPI currently in use

Reimplemented from BaseRenderEngine.

◆ InitImpl()

virtual bool InitImpl ( )

overrideprotectedvirtual

Implements BaseRenderEngine.

◆ Instance()

static OgreRenderEngine* Instance ( )

static

Get a pointer to the render engine.

Todo:: (anyone) Remove inheritance from Singleton base class

Returns: a pointer to the render engine

◆ 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] _params Parameters 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:

gz/rendering/ogre/OgreRenderEngine.hh

Gazebo Rendering

API Reference

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Member Enumeration Documentation

◆ OgreRenderPathType

Constructor & Destructor Documentation

◆ ~OgreRenderEngine()

Member Function Documentation

◆ AddResourcePath()

◆ CreateRenderWindow()

◆ CreateSceneImpl()

◆ Destroy()

◆ FSAALevels()

◆ GraphicsAPI()

◆ InitImpl()

◆ Instance()

◆ IsEnabled()

◆ LoadImpl()

◆ Name()

◆ OgreRoot()

◆ RenderPathType()

◆ Scenes()