The SceneManagerPortals calss implements a portal-based hidden surface removal algorithm to efficently render highly occluded scenes. More...

#include <SceneManagerPortals.hpp>

Inheritance diagram for vl::SceneManagerPortals:

List of all members.

Public Member Functions
	SceneManagerPortals ()
	Constructor.
void	extractActors (ActorCollection &list)
	Appends to the given list all the Actor[s] contained in the scene regardless of their visibility.
void	extractVisibleActors (ActorCollection &list, const Camera *camera)
	Appends to the given list all the visible Actor[s] using the portal culling algorithm.
std::vector< ref< Sector > > &	sectors ()
	The Sectors that are part of the scene.
const std::vector< ref< Sector > > &	sectors () const
	The Sectors that are part of the scene.
Sector *	externalSector ()
	Returns the external sector.
const Sector *	externalSector () const
	Returns the external sector.
void	computePortalNormals ()
	Compute the normal of the sectors.
void	initialize ()
	Calls computePortalNormals() and performs some error checking.
bool	showPortals () const
	Whether portals should be shown in the rendering or not.
void	setShowPortals (bool show)
	Whether portals should be shown in the rendering or not.
void	invalidatePortalActors ()
	Regenerates the portal actors next time their rendering is requested.
const std::vector< Frustum > &	frustumStack () const
	The stack of frustums active at a given point during sector discovery.
Protected Member Functions
void	renderPortal (Portal *portal)
void	visitSector (Sector prev, Sector sector, const vec3 &eye, const Camera *camera)
Sector *	computeStartingSector (const Camera *camera)
Protected Attributes
ref< Sector >	mExternalSector
std::vector< ref< Sector > >	mSectors
std::vector< ref< Actor > >	mTempActors
std::map< Portal *, ref< Actor > >	mPortalActorMap
std::vector< Frustum >	mFrustumStack
unsigned	mVisitTick
bool	mShowPortals

Detailed Description

The SceneManagerPortals calss implements a portal-based hidden surface removal algorithm to efficently render highly occluded scenes.

See also:

Definition at line 184 of file SceneManagerPortals.hpp.

Constructor & Destructor Documentation

vl::SceneManagerPortals::SceneManagerPortals ( ) [inline]

Constructor.

Definition at line 190 of file SceneManagerPortals.hpp.

References VL_DEBUG_SET_OBJECT_NAME.

Member Function Documentation

void SceneManagerPortals::extractActors ( ActorCollection & list ) [virtual]

Appends to the given list all the Actor[s] contained in the scene regardless of their visibility.

Implements vl::SceneManager.

Definition at line 129 of file SceneManagerPortals.cpp.

References mSectors, and vl::Collection< T >::push_back().

Referenced by extractVisibleActors().

void SceneManagerPortals::extractVisibleActors	(	ActorCollection &	list,
		const Camera *	camera
	)		`[virtual]`

Appends to the given list all the visible Actor[s] using the portal culling algorithm.

Implements vl::SceneManager.

Definition at line 136 of file SceneManagerPortals.cpp.

References computeStartingSector(), vl::SceneManager::cullingEnabled(), vl::Sector::executeCallbacks(), extractActors(), vl::Camera::frustum(), vl::Matrix4< T_Scalar >::getT(), mFrustumStack, vl::Camera::modelingMatrix(), mTempActors, mVisitTick, NULL, vl::Collection< T >::push_back(), and visitSector().

std::vector< ref<Sector> >& vl::SceneManagerPortals::sectors ( ) [inline]

The Sectors that are part of the scene.

Definition at line 201 of file SceneManagerPortals.hpp.

Referenced by computeStartingSector().

const std::vector< ref<Sector> >& vl::SceneManagerPortals::sectors ( ) const [inline]

The Sectors that are part of the scene.

Definition at line 203 of file SceneManagerPortals.hpp.

Sector* vl::SceneManagerPortals::externalSector ( ) [inline]

Returns the external sector.

The external sector is a special sector that is considered visible when the camera is not inside any other sector. The external sector can be used to contain objects that are outside the indoor environment defined by the other "normal" sectors. For example, you could use the SceneManagerPortals to model a house and put in the external sector all the objects that are outside the house. The portals inside the house can point to the external sector so that the objects outside the house are rendered only if they are visible through a door or a window for maximum performances. Of course you can also go from an external sector to an internal sector just as well using one or more portals.

Definition at line 212 of file SceneManagerPortals.hpp.

Referenced by computeStartingSector().

const Sector* vl::SceneManagerPortals::externalSector ( ) const [inline]

Returns the external sector.

Definition at line 214 of file SceneManagerPortals.hpp.

void SceneManagerPortals::computePortalNormals ( )

Compute the normal of the sectors.

Definition at line 229 of file SceneManagerPortals.cpp.

References mSectors.

Referenced by initialize().

void SceneManagerPortals::initialize ( )

Calls computePortalNormals() and performs some error checking.