Ogre::PlaneOptimalShadowCameraSetup Class Reference

Implements the plane optimal shadow camera algorithm. More...

#include <OgreShadowCameraSetupPlaneOptimal.h>

Inheritance diagram for Ogre::PlaneOptimalShadowCameraSetup:

Public Member Functions
	PlaneOptimalShadowCameraSetup (MovablePlane *plane)
	Constructor – requires a plane of interest.
virtual	~PlaneOptimalShadowCameraSetup ()
	Destructor.
Real	getMaxDistance () const
Real	getMinDistance () const
virtual void	getShadowCamera (const SceneManager *sm, const Camera *cam, const Light *light, Camera *texCam, size_t iteration, const Vector2 &viewportRealSize) const
	Returns shadow camera configured to get 1-1 homography between screen and shadow map when restricted to plane.
void	operator delete (void *ptr)
void	operator delete (void *ptr, const char *, int, const char *)
void	operator delete (void *ptr, void *)
void	operator delete[] (void *ptr)
void	operator delete[] (void *ptr, const char *, int, const char *)
void *	operator new (size_t sz)
void *	operator new (size_t sz, const char *file, int line, const char *func)
	operator new, with debug line info
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz)
void *	operator new[] (size_t sz, const char *file, int line, const char *func)
	array operator new, with debug line info

Detailed Description

Implements the plane optimal shadow camera algorithm.

Remarks

Given a plane of interest, it is possible to set up the shadow camera matrix such that the mapping between screen and shadow map is the identity (when restricted to pixels that view the plane of interest). Therefore, if the shadow map resolution matches the screen space resolution (of the seen planar receiver), we can get pixel perfect shadowing on the plane. Off the plane, the shadowing is not guaranteed to be perfect and will likely exhibit the usual sampling artifacts associated with shadow mapping.

Note

Important: this routine requires double-precision calculations. When you are running under Direct3D, you must ensure that you set the floating point mode to 'Consistent' rather than 'Fastest' to ensure this precision. This does allegedly come with some performance cost but when measuring it appears to be negligible in modern systems for normal usage.

Second important note: this projection also only works for lights with a finite position. Therefore you cannot use it for directional lights at this time.

Constructor & Destructor Documentation

PlaneOptimalShadowCameraSetup()

Ogre::PlaneOptimalShadowCameraSetup::PlaneOptimalShadowCameraSetup

(

MovablePlane *

plane

)

Constructor – requires a plane of interest.

~PlaneOptimalShadowCameraSetup()

virtual Ogre::PlaneOptimalShadowCameraSetup::~PlaneOptimalShadowCameraSetup ( )

virtual

Destructor.

Member Function Documentation

getMaxDistance()

Real Ogre::ShadowCameraSetup::getMaxDistance ( ) const

inlineinherited

getMinDistance()

Real Ogre::ShadowCameraSetup::getMinDistance ( ) const

inlineinherited

getShadowCamera()

virtual void Ogre::PlaneOptimalShadowCameraSetup::getShadowCamera ( const SceneManager *  sm, const Camera *  cam, const Light *  light, Camera *  texCam, size_t  iteration, const Vector2 &  viewportRealSize  ) const

virtual

Returns shadow camera configured to get 1-1 homography between screen and shadow map when restricted to plane.

Implements Ogre::ShadowCameraSetup.

operator delete() [1/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr )

inlineinherited

operator delete() [2/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr, const char *  , int  , const char *    )

inlineinherited

operator delete() [3/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr, void *    )

inlineinherited

operator delete[]() [1/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr )

inlineinherited

operator delete[]() [2/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr, const char *  , int  , const char *    )

inlineinherited

operator new() [1/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz )

inlineinherited

operator new() [2/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz, const char *  file, int  line, const char *  func  )

inlineinherited

operator new, with debug line info

operator new() [3/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz, void *  ptr  )

inlineinherited

placement operator new

operator new[]() [1/2]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz )

inlineinherited

operator new[]() [2/2]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz, const char *  file, int  line, const char *  func  )

inlineinherited

array operator new, with debug line info

---

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

• OgreShadowCameraSetupPlaneOptimal.h