High-level rendering subsystem. Manages drawing of 3D views. More...

#include <Urho3D/Graphics/Renderer.h>

Inheritance diagram for Urho3D::Renderer:

Public Member Functions
	Renderer (Context *context)
	Construct.

	~Renderer () override
	Destruct.

void	SetBackbufferRenderSurface (RenderSurface *renderSurface)
	Set backbuffer render surface. Null corresponds to the application backbuffer.

void	SetNumViewports (unsigned num)

void	SetViewport (unsigned index, Viewport *viewport)

void	SetDefaultTechnique (Technique *technique)

void	SetTextureAnisotropy (int level)

void	SetTextureFilterMode (TextureFilterMode mode)

void	SetTextureQuality (MaterialQuality quality)

void	SetSkinningMode (SkinningMode mode)
	Set skinning mode.

void	SetNumSoftwareSkinningBones (unsigned numBones)
	Set number of bones used for software skinning.

unsigned	GetNumViewports () const

Viewport *	GetViewport (unsigned index) const

Viewport *	GetViewportForScene (Scene *scene, unsigned index) const
	Return nth backbuffer viewport associated to a scene. Index 0 returns the first.

Technique *	GetDefaultTechnique () const

int	GetTextureAnisotropy () const

TextureFilterMode	GetTextureFilterMode () const

MaterialQuality	GetTextureQuality () const

SkinningMode	GetSkinningMode () const
	Return skinning mode.

bool	GetUseHardwareSkinning () const
	Return whether hardware skinning is used.

unsigned	GetNumSoftwareSkinningBones () const
	Return number of bones used for software skinning.

unsigned	GetNumViews () const

unsigned	GetNumGeometries () const

unsigned	GetNumLights () const

unsigned	GetNumShadowMaps () const

unsigned	GetNumOccluders () const

Zone *	GetDefaultZone () const

Material *	GetDefaultMaterial () const

Texture2D *	GetDefaultLightRamp () const

Texture2D *	GetDefaultLightSpot () const

TextureCube *	GetBlackCubeMap () const
	Return completely black 1x1x1 cubemap.

const FrameInfo &	GetFrameInfo () const
	Return the frame update parameters.

const FrameStatistics &	GetFrameStats () const
	Return statistics of current frame.

FrameStatistics &	GetMutableFrameStats ()

void	Update (float timeStep)
	Update for rendering. Called by HandleRenderUpdate().

void	Render ()
	Render. Called by Engine.

void	DrawDebugGeometry (bool depthTest)
	Add debug geometry to the debug renderer.

void	QueueRenderSurface (RenderSurface *renderTarget)
	Queue a render surface's viewports for rendering. Called by the surface, or by View.

void	QueueViewport (RenderSurface renderTarget, Viewport viewport)
	Queue a viewport for rendering. Null surface means backbuffer.

Geometry *	GetLightGeometry (Light *light)
	Return volume geometry for a light.

Geometry *	GetQuadGeometry ()
	Return quad geometry used in postprocessing.

Public Member Functions inherited from Urho3D::Object
	Object (Context *context)
	Construct.

	~Object () override
	Destruct. Clean up self from event sender & receiver structures.

virtual StringHash	GetType () const =0

virtual const ea::string &	GetTypeName () const =0

virtual const TypeInfo *	GetTypeInfo () const =0
	Return type info.

virtual bool	IsInstanceOf (StringHash type) const =0
	Check whether current instance implements specified type.

virtual void	OnEvent (Object *sender, StringHash eventType, VariantMap &eventData)
	Handle event.

virtual void	SerializeInBlock (Archive &archive)
	Serialize content from/to archive. May throw ArchiveException.

template<typename T >
bool	IsInstanceOf () const
	Check current instance is type of specified class.

template<typename T >
T *	Cast ()
	Cast the object to specified most derived class.

template<typename T >
const T *	Cast () const
	Cast the object to specified most derived class.

void	SubscribeToEventManual (StringHash eventType, EventHandler *handler)
	Subscribe to an event that can be sent by any sender.

void	SubscribeToEventManual (Object sender, StringHash eventType, EventHandler handler)
	Subscribe to a specific sender's event.

template<class T >
void	SubscribeToEvent (StringHash eventType, T handler)
	Subscribe to an event that can be sent by any sender.

template<class T >
void	SubscribeToEvent (Object *sender, StringHash eventType, T handler)
	Subscribe to a specific sender's event.

void	UnsubscribeFromEvent (StringHash eventType)
	Unsubscribe from an event.

void	UnsubscribeFromEvent (Object *sender, StringHash eventType)
	Unsubscribe from a specific sender's event.

void	UnsubscribeFromEvents (Object *sender)
	Unsubscribe from a specific sender's events.

void	UnsubscribeFromAllEvents ()
	Unsubscribe from all events.

void	UnsubscribeFromAllEventsExcept (const ea::vector< StringHash > &exceptions)
	Unsubscribe from all events except those listed.

void	UnsubscribeFromAllEventsExcept (const ea::vector< Object * > &exceptions)
	Unsubscribe from all events except those with listed senders.

void	SendEvent (StringHash eventType)
	Send event to all subscribers.

void	SendEvent (StringHash eventType, VariantMap &eventData)
	Send event with parameters to all subscribers.

VariantMap &	GetEventDataMap () const
	Return a preallocated map for event data. Used for optimization to avoid constant re-allocation of event data maps.

template<typename... Args>
void	SendEvent (StringHash eventType, const Args &... args)
	Send event with variadic parameter pairs to all subscribers. The parameters are (paramID, paramValue) pairs.

Context *	GetContext () const
	Return execution context.

const Variant &	GetGlobalVar (StringHash key) const

const VariantMap &	GetGlobalVars () const

void	SetGlobalVar (StringHash key, const Variant &value)

Object *	GetSubsystem (StringHash type) const
	Return subsystem by type.

Object *	GetEventSender () const
	Return active event sender. Null outside event handling.

EventHandler *	GetEventHandler () const
	Return active event handler. Null outside event handling.

bool	HasSubscribedToEvent (StringHash eventType) const
	Return whether has subscribed to an event without specific sender.

bool	HasSubscribedToEvent (Object *sender, StringHash eventType) const
	Return whether has subscribed to a specific sender's event.

bool	HasEventHandlers () const
	Return whether has subscribed to any event.

template<class T >
T *	GetSubsystem () const
	Template version of returning a subsystem.

const ea::string &	GetCategory () const

void	SendEvent (StringHash eventType, const VariantMap &eventData)
	Send event with parameters to all subscribers.

void	SetBlockEvents (bool block)
	Block object from sending and receiving events.

bool	GetBlockEvents () const
	Return sending and receiving events blocking status.

Public Member Functions inherited from Urho3D::RefCounted
	RefCounted ()
	Construct. Allocate the reference count structure and set an initial self weak reference.

virtual	~RefCounted ()
	Destruct. Mark as expired and also delete the reference count structure if no outside weak references exist.

	RefCounted (const RefCounted &rhs)=delete
	Prevent copy construction.

RefCounted &	operator= (const RefCounted &rhs)=delete
	Prevent assignment.

int	AddRef ()

int	ReleaseRef ()

int	Refs () const

int	WeakRefs () const

RefCount *	RefCountPtr () const
	Return pointer to the reference count structure.

bool	HasScriptObject () const
	Return true if script runtime object wrapping this native object exists.

bool	IsScriptStrongRef () const
	Return true if script reference is strong.

Private Member Functions
	URHO3D_OBJECT (Renderer, Object)

void	Initialize ()
	Initialize when screen mode initially set.

void	ReleaseMaterialShaders ()
	Release shaders used in materials.

void	ReloadTextures ()
	Reload textures.

void	CreateGeometries ()
	Create light volume geometries.

void	UpdateQueuedViewport (unsigned index)
	Update a queued viewport for rendering. More...

void	HandleScreenMode (StringHash eventType, VariantMap &eventData)
	Handle screen mode event.

void	HandleRenderUpdate (StringHash eventType, VariantMap &eventData)
	Handle render update event.

void	UpdateMousePositionsForMainViewports ()

Private Attributes
WeakPtr< Graphics >	graphics_
	Graphics subsystem.

WeakPtr< RenderSurface >	backbufferSurface_
	Render surface that acts as backbuffer.

bool	backbufferSurfaceViewportsDirty_ {}

SharedPtr< Technique >	defaultTechnique_
	Default non-textured material technique.

SharedPtr< Zone >	defaultZone_
	Default zone.

SharedPtr< Geometry >	dirLightGeometry_
	Directional light quad geometry.

SharedPtr< Geometry >	spotLightGeometry_
	Spot light volume geometry.

SharedPtr< Geometry >	pointLightGeometry_
	Point light volume geometry.

SharedPtr< Material >	defaultMaterial_
	Default material.

SharedPtr< Texture2D >	defaultLightRamp_
	Default range attenuation texture.

SharedPtr< Texture2D >	defaultLightSpot_
	Default spotlight attenuation texture.

SharedPtr< TextureCube >	blackCubeMap_

ea::vector< SharedPtr< Viewport > >	viewports_
	Backbuffer viewports.

ea::vector< ea::pair< WeakPtr< RenderSurface >, WeakPtr< Viewport > > >	queuedViewports_
	Render surface viewports queued for update.

ea::vector< WeakPtr< RenderPipelineView > >	renderPipelineViews_
	Render pipeline views that have been processed this frame.

ea::hash_set< Octree * >	updatedOctrees_
	Octrees that have been updated during the frame.

ea::hash_set< Technique * >	shaderErrorDisplayed_
	Techniques for which missing shader error has been displayed.

FrameInfo	frame_
	Frame info for rendering.

int	textureAnisotropy_ {4}
	Texture anisotropy level.

TextureFilterMode	textureFilterMode_ {FILTER_TRILINEAR}
	Texture filtering mode.

MaterialQuality	textureQuality_ {QUALITY_HIGH}
	Texture quality level.

bool	initialized_ {}
	Initialized flag.

bool	resetViews_ {}
	Flag for views needing reset.

bool	hardwareSkinningSupported_ { true }
	Whether hardware skinning is supported.

SkinningMode	skinningMode_ {}
	Skinning mode.

unsigned	numSoftwareSkinningBones_ { 4 }
	Number of bones used for software skinning.

FrameStatistics	frameStats_

Additional Inherited Members
Static Public Member Functions inherited from Urho3D::Object
static const TypeInfo *	GetTypeInfoStatic ()
	Return type info static.

Static Public Attributes inherited from Urho3D::Object
static constexpr ea::array< StringHash, 0 >	TypeHierarchy {}

Protected Attributes inherited from Urho3D::Object
WeakPtr< Context >	context_
	Execution context.

Detailed Description

High-level rendering subsystem. Manages drawing of 3D views.

Member Function Documentation

◆ GetDefaultLightRamp()

Texture2D* Urho3D::Renderer::GetDefaultLightRamp ( ) const

inline

Return the default range attenuation texture.

◆ GetDefaultLightSpot()

Texture2D* Urho3D::Renderer::GetDefaultLightSpot ( ) const

inline

Return the default spotlight attenuation texture.

◆ GetDefaultMaterial()

Material* Urho3D::Renderer::GetDefaultMaterial ( ) const

inline

Return the default material.

◆ GetDefaultTechnique()

Technique * Urho3D::Renderer::GetDefaultTechnique ( ) const

Return default non-textured material technique.

◆ GetDefaultZone()

Zone* Urho3D::Renderer::GetDefaultZone ( ) const

inline

Return the default zone.

◆ GetNumGeometries()

unsigned Urho3D::Renderer::GetNumGeometries ( ) const

Return number of geometries rendered.

◆ GetNumLights()

unsigned Urho3D::Renderer::GetNumLights ( ) const

Return number of lights rendered.

◆ GetNumOccluders()

unsigned Urho3D::Renderer::GetNumOccluders ( ) const

Return number of occluders rendered.

◆ GetNumShadowMaps()

unsigned Urho3D::Renderer::GetNumShadowMaps ( ) const

Return number of shadow maps rendered.

◆ GetNumViewports()

unsigned Urho3D::Renderer::GetNumViewports ( ) const

inline

Return number of backbuffer viewports.

◆ GetNumViews()

unsigned Urho3D::Renderer::GetNumViews ( ) const

inline

Return number of views rendered.

◆ GetTextureAnisotropy()

int Urho3D::Renderer::GetTextureAnisotropy ( ) const

inline

Return default texture max. anisotropy level.

◆ GetTextureFilterMode()

TextureFilterMode Urho3D::Renderer::GetTextureFilterMode ( ) const

inline

Return default texture filtering mode.

◆ GetTextureQuality()

MaterialQuality Urho3D::Renderer::GetTextureQuality ( ) const

inline

Return texture quality level.

◆ GetViewport()

Viewport * Urho3D::Renderer::GetViewport ( unsigned index ) const

Return backbuffer viewport by index.

◆ SetDefaultTechnique()

void Urho3D::Renderer::SetDefaultTechnique ( Technique * technique )

Set default non-textured material technique.

◆ SetNumViewports()

void Urho3D::Renderer::SetNumViewports ( unsigned num )

Set number of backbuffer viewports to render.

◆ SetTextureAnisotropy()

void Urho3D::Renderer::SetTextureAnisotropy ( int level )

Set default texture max anisotropy level.

◆ SetTextureFilterMode()

void Urho3D::Renderer::SetTextureFilterMode ( TextureFilterMode mode )

Set default texture filtering.

◆ SetTextureQuality()

void Urho3D::Renderer::SetTextureQuality ( MaterialQuality quality )

Set texture quality level. See the QUALITY constants in GraphicsDefs.h.

◆ SetViewport()

void Urho3D::Renderer::SetViewport	(	unsigned	index,
		Viewport *	viewport
	)

Set a backbuffer viewport.

◆ UpdateQueuedViewport()

void Urho3D::Renderer::UpdateQueuedViewport ( unsigned index )

private

Update a queued viewport for rendering.

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

Urho3D/Graphics/Renderer.h
Urho3D/Graphics/Renderer.cpp

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ GetDefaultLightRamp()

◆ GetDefaultLightSpot()

◆ GetDefaultMaterial()

◆ GetDefaultTechnique()

◆ GetDefaultZone()

◆ GetNumGeometries()

◆ GetNumLights()

◆ GetNumOccluders()

◆ GetNumShadowMaps()

◆ GetNumViewports()

◆ GetNumViews()

◆ GetTextureAnisotropy()

◆ GetTextureFilterMode()

◆ GetTextureQuality()

◆ GetViewport()

◆ SetDefaultTechnique()

◆ SetNumViewports()

◆ SetTextureAnisotropy()

◆ SetTextureFilterMode()

◆ SetTextureQuality()

◆ SetViewport()

◆ UpdateQueuedViewport()