Ogre::PlaneOptimalShadowCameraSetup Class Reference
[Scene]

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

#include <OgreShadowCameraSetupPlaneOptimal.h>

Inheritance diagram for Ogre::PlaneOptimalShadowCameraSetup:

[legend]

List of all members.

Public Member Functions
	PlaneOptimalShadowCameraSetup (MovablePlane *plane)
	Constructor -- requires a plane of interest.
virtual	~PlaneOptimalShadowCameraSetup ()
	Destructor.
virtual void	getShadowCamera (const SceneManager *sm, const Camera *cam, const Viewport *vp, const Light *light, Camera *texCam, size_t iteration) const
	Returns shadow camera configured to get 1-1 homography between screen and shadow map when restricted to plane.
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 *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz, const char *file, int line, const char *func)
	array operator new, with debug line info
void *	operator new[] (size_t sz)
void	operator delete (void *ptr)
void	operator delete (void *ptr, void *)
void	operator delete (void *ptr, const char *, int, const char *)
void	operator delete[] (void *ptr)
void	operator delete[] (void *ptr, const char *, int, const char *)
Private Member Functions
	PlaneOptimalShadowCameraSetup ()
	Default constructor is private.
Matrix4	computeConstrainedProjection (const Vector4 &pinhole, const vector< Vector4 >::type &fpoint, const vector< Vector2 >::type &constraint) const
	helper function computing projection matrix given constraints
Private Attributes
MovablePlane *	mPlane
	pointer to plane of interest

---

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.

Definition at line 61 of file OgreShadowCameraSetupPlaneOptimal.h.

---

Constructor & Destructor Documentation

Ogre::PlaneOptimalShadowCameraSetup::PlaneOptimalShadowCameraSetup

(

)

[private]

Default constructor is private.

Definition at line 66 of file OgreShadowCameraSetupPlaneOptimal.h.

Ogre::PlaneOptimalShadowCameraSetup::PlaneOptimalShadowCameraSetup

(

MovablePlane *

plane

)

Constructor -- requires a plane of interest.

virtual Ogre::PlaneOptimalShadowCameraSetup::~PlaneOptimalShadowCameraSetup

(

)

[virtual]

Destructor.

---

Member Function Documentation

Matrix4 Ogre::PlaneOptimalShadowCameraSetup::computeConstrainedProjection	(	const Vector4 &	pinhole,
		const vector< Vector4 >::type &	fpoint,
		const vector< Vector2 >::type &	constraint
	)			const [private]

helper function computing projection matrix given constraints

virtual void Ogre::PlaneOptimalShadowCameraSetup::getShadowCamera	(	const SceneManager *	sm,
		const Camera *	cam,
		const Viewport *	vp,
		const Light *	light,
		Camera *	texCam,
		size_t	iteration
	)			const [virtual]

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

Implements Ogre::ShadowCameraSetup.

template<class Alloc >

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

Definition at line 107 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

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

Definition at line 101 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete

(

void *

ptr

)

[inherited]

Definition at line 95 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

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

Definition at line 118 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[]

(

void *

ptr

)

[inherited]

Definition at line 112 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

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

placement operator new

Definition at line 78 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new

(

size_t

sz

)

[inherited]

Definition at line 72 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

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

operator new, with debug line info

Definition at line 67 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[]

(

size_t

sz

)

[inherited]

Definition at line 90 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

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

array operator new, with debug line info

Definition at line 85 of file OgreMemoryAllocatedObject.h.

---

Member Data Documentation

MovablePlane* Ogre::PlaneOptimalShadowCameraSetup::mPlane [private]

pointer to plane of interest

Definition at line 64 of file OgreShadowCameraSetupPlaneOptimal.h.

---

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

• OgreShadowCameraSetupPlaneOptimal.h