Implements a geometry rendering stage that renders meshes. More...

#include <MeshRenderingStage.h>

Inheritance diagram for Carna::base::MeshRenderingStage< RenderableCompare >:

Collaboration diagram for Carna::base::MeshRenderingStage< RenderableCompare >:

Public Member Functions
	MeshRenderingStage (unsigned int geometryType)
	Instantiates. More...

MeshRenderingStage *	clone () const override
	Returns same `RenderStage` implementation with same configuration. More...

virtual void	renderPass (const math::Matrix4f &viewTransform, RenderTask &rt, const Viewport &vp) override
	Called once per pass. More...

Public Member Functions inherited from Carna::base::GeometryStage< RenderableCompare >
	GeometryStage (unsigned int geometryType, unsigned int geometryTypeMask=RenderQueue< RenderableCompare >::EXACT_MATCH_GEOMETRY_TYPE_MASK)
	Instantiates s.t. the predefined rendering queue enqueues such Carna::base::Geometry scene graph nodes, whose geometry type AND-linked with geometryTypeMask equals the geometryType specified here.

virtual	~GeometryStage ()
	Releases acquired video resources.

virtual void	prepareFrame (Node &root) override
	Called once before each frame. More...

std::size_t	renderedPassesCount () const
	Tells the number of passes rendered so far since the beginning of the current frame.

template<typename GeometryFeatureType >
GeometryFeatureType::ManagedInterface &	videoResource (GeometryFeatureType &geometryFeature) const
	Interfaces the geometryFeature video resources that were acquired by this rendering stage.

template<typename GeometryFeatureType >
const GeometryFeatureType::ManagedInterface &	videoResource (const GeometryFeatureType &geometryFeature) const

Public Member Functions inherited from Carna::base::RenderStage
	RenderStage ()
	Instantiates in enabled-state.

virtual	~RenderStage ()
	Deletes.

void	setViewTransformFixed (bool viewTransformFixed)
	Sets whether the view transform is pass-invariant for the duration of a single frame. More...

bool	isViewTransformFixed () const
	Tells whether the view transform is pass-invariant for the duration of a single frame.

virtual void	reshape (FrameRenderer &fr, unsigned int width, unsigned int height)
	Orders this stage to reshape its buffers according to the specified dimensions. More...

bool	isInitialized () const
	Tells whether this stage is ready for rendering. More...

bool	isEnabled () const
	Tells whether this stage is enabled. Disabled stages are not rendered by render tasks.

void	setEnabled (bool)
	Sets whether this stage is enabled. Disabled stages are not rendered by render tasks.

base::FrameRenderer &	renderer ()
	References the renderer this stage belongs to. More...

const base::FrameRenderer &	renderer () const

void	addRenderStageListener (RenderStageListener &listener)
	Adds listener to the set of listeners this instance notifies in \(\mathcal O\left(\log n\right)\).

void	removeRenderStageListener (RenderStageListener &listener)
	Removes listener from the set of listeners this instance notifies in \(\mathcal O\left(\log n\right)\).

Public Member Functions inherited from Carna::base::MeshRenderingStageBase
	MeshRenderingStageBase (unsigned int geometryType)
	Instantiates. More...

virtual	~MeshRenderingStageBase ()
	Does nothing.

Protected Member Functions
virtual void	render (const Renderable &renderable) override
	Renders the renderable. More...

Protected Member Functions inherited from Carna::base::GeometryStage< RenderableCompare >
void	activateGLContext () const
	Ensures that the OpenGL context of the hosting Carna::base::FrameRenderer is the current one.

virtual void	buildRenderQueues (Node &root, const math::Matrix4f &viewTransform)
	Builds the rendering queues of this stage.

virtual void	rewindRenderQueues ()
	Rewinds the rendering queues of this stage.

virtual void	updateRenderQueues (const math::Matrix4f &viewTransform)
	Recomputes the model-view transforms of the renderables enqueued by this stage.

Additional Inherited Members
Public Attributes inherited from Carna::base::GeometryStage< RenderableCompare >
const unsigned int	geometryType
	Renders such geometries whose type AND-linked with geometryTypeMask equals this.

const unsigned int	geometryTypeMask
	Renders such geometries whose type AND-linked with this equals geometryType.

Public Attributes inherited from Carna::base::MeshRenderingStageBase
const unsigned int	geometryType
	Holds the geometry type rendered by this MeshRenderingStage.

Static Public Attributes inherited from Carna::base::MeshRenderingStageBase
static const unsigned int	ROLE_DEFAULT_MESH = 0
	Identifies the Mesh object that MeshRenderingStage uses for rendering.

static const unsigned int	ROLE_DEFAULT_MATERIAL = 1
	Identifies the Material object that MeshRenderingStage uses for rendering.

Protected Attributes inherited from Carna::base::GeometryStage< RenderableCompare >
RenderQueue< RenderableCompare >	rq
	Holds the predefined rendering queue of this rendering stage.

Detailed Description

template<typename RenderableCompare>
class Carna::base::MeshRenderingStage< RenderableCompare >

Implements a geometry rendering stage that renders meshes.

See also: Refer to the documentation of the rendering process for further notes on how rendering stages operate.

An instance of this rendering stage expects two features from the Geometry objects it processes:

ROLE_DEFAULT_MESH must be a Mesh object.
ROLE_DEFAULT_MATERIAL must be a Material object.

Author: Leonid Kostrykin

Date: 21.2.15 - 6.3.15

Definition at line 108 of file MeshRenderingStage.h.

Constructor & Destructor Documentation

template<typename RenderableCompare >

Carna::base::MeshRenderingStage< RenderableCompare >::MeshRenderingStage ( unsigned int geometryType )

Instantiates.

Parameters

geometryType is the geometry type rendered by this stage.

Definition at line 139 of file MeshRenderingStage.h.

Member Function Documentation

template<typename RenderableCompare >

MeshRenderingStage< RenderableCompare > * Carna::base::MeshRenderingStage< RenderableCompare >::clone ( ) const

overridevirtual

Returns same RenderStage implementation with same configuration.

The listeners and the rendering state are not copied.

Deprecated:: Do not use this method. It will be removed shortly.

Implements Carna::base::RenderStage.

Definition at line 147 of file MeshRenderingStage.h.

template<typename RenderableCompare >

void Carna::base::MeshRenderingStage< RenderableCompare >::render ( const Renderable & renderable )

overrideprotectedvirtual

Renders the renderable.

Implements Carna::base::GeometryStage< RenderableCompare >.

Definition at line 166 of file MeshRenderingStage.h.

template<typename RenderableCompare >

void Carna::base::MeshRenderingStage< RenderableCompare >::renderPass	(	const math::Matrix4f &	viewTransform,
		RenderTask &	rt,
		const Viewport &	vp
	)

overridevirtual

Called once per pass.

If this rendering stage maintains one or more Carna::base::RenderQueue objects, than this is the right place to build them. Note that the queues need to be rebuilt only once per frame and not per pass, unless isViewTransformFixed is false. If it is true and this is not the first invocation of this method since the last time prepareFrame was called, rewinding the queue will be sufficient.

Reimplemented from Carna::base::GeometryStage< RenderableCompare >.

Reimplemented in Carna::presets::TransparentRenderingStage.

Definition at line 157 of file MeshRenderingStage.h.

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

include/Carna/base/MeshRenderingStage.h

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

template<typename RenderableCompare> class Carna::base::MeshRenderingStage< RenderableCompare >

Constructor & Destructor Documentation

Member Function Documentation

template<typename RenderableCompare>
class Carna::base::MeshRenderingStage< RenderableCompare >