#include <CUFrustum.h>

Public Types
enum	Region { Region::INSIDE, Region::OUTSIDE, Region::INTERSECT }

enum	Side : unsigned int { Side::CLOSE = 0, Side::AWAY = 1, Side::LEFT = 2, Side::RIGHT = 3, Side::TOP = 4, Side::BOTTOM = 5 }

Public Member Functions
	Frustum ()

	Frustum (const Mat4 &inverseView)

	Frustum (const Frustum &frustum)

	~Frustum ()

Frustum &	operator= (const Mat4 &inverseView)

Frustum &	operator= (const Frustum &frustum)

Frustum &	set (const Mat4 &inverseView)

Frustum &	set (const Frustum &frustum)

const Plane &	getPlane (Side side)

const Vec3 &	getCorner (unsigned int index)

Region	find (const Vec3 point)

Region	find (float x, float y, float z)

Region	findSphere (const Vec3 &center, float radius)

Region	findSphere (float x, float y, float z, float radius)

Region	findSphereWithoutNearFar (const Vec3 &center, float radius)

Region	findSphereWithoutNearFar (float x, float y, float z, float radius)

Region	findBox (const Vec3 &center, const Vec3 &dimension)

Region	findBox (float x, float y, float z, float halfWidth, float halfHeight, float halfDepth)

Static Public Attributes
static const int	PLANE_COUNT = 6

static const int	CORNER_COUNT = 8

Detailed Description

This class is a truncated rectangular pyramid.

A frustum is used to define the viewable region and its projection onto the screen. Normally, we would embed this into a camera class. However, we do not want our cameras any more heavy weight than they are, so we pull them out.

Member Enumeration Documentation

enum cugl::Frustum::Region

strong

The three frustum locations

Enumerator
INSIDE	The shape is fully inside the frustum
OUTSIDE	The shape is fully outside the frustum
INTERSECT	The shape intersects the frustum

enum cugl::Frustum::Side : unsigned int

strong

This enum is used to index the six clipping planes

Enumerator
CLOSE	The near clipping plane
AWAY	The far clipping plane
LEFT	The left clipping plane
RIGHT	The right clipping plane
TOP	The top clipping plane
BOTTOM	The bottom clipping plane

Constructor & Destructor Documentation

cugl::Frustum::Frustum ( )

inline

Creates a frustum for the identity matrix.

cugl::Frustum::Frustum ( const Mat4 & inverseView )

inline

Creates a frustum for the inverse projection view matrix.

Parameters

inverseView The inverse projection view matrix.

cugl::Frustum::Frustum ( const Frustum & frustum )

inline

Creates a copy of the given frustum.

Parameters

frustum The frustum to copy.

cugl::Frustum::~Frustum ( )

inline

Destroys this frustum, releasing all resources

Member Function Documentation

Region cugl::Frustum::find ( const Vec3 point )

Returns the location of the point with respect to the frustum.

Parameters

point The point to check.

Returns: the location of the point with respect to the frustum.

Region cugl::Frustum::find	(	float	x,
		float	y,
		float	z
	)

inline

Returns the location of the point with respect to the frustum.

Parameters

x	The x-coordinate of the point
y	The y-coordinate of the point
z	The z-coordinate of the point

Returns: the location of the point with respect to the frustum.

Region cugl::Frustum::findBox	(	const Vec3 &	center,
		const Vec3 &	dimension
	)

inline

Returns the location of the bounding box with respect to the frustum.

The bounding box is a cube, defined by its center and dimenion along each axis.

Parameters

center	The center of the bounding box
dimension	The dimensions of the bounding box

Returns: the location of the bounding box with respect to the frustum.

Region cugl::Frustum::findBox	(	float	x,
		float	y,
		float	z,
		float	halfWidth,
		float	halfHeight,
		float	halfDepth
	)

Returns the location of the bounding box with respect to the frustum.

The bounding box is a cube, defined by its center and dimenion along each axis.

Parameters

x	The x-coordinate of the center of the bounding box
y	The y-coordinate of the center of the bounding box
z	The z-coordinate of the center of the bounding box
halfWidth	Half of the width (x-axis) of the bounding box
halfHeight	Half of the height (y-axis) of the bounding box
halfDepth	Half of the depth (z-axis) of the bounding box

Returns: the location of the bounding box with respect to the frustum.

Region cugl::Frustum::findSphere	(	const Vec3 &	center,
		float	radius
	)

Returns the location of the sphere with respect to the frustum.

Parameters

center	The center of the sphere
radius	The radius of the sphere

Returns: the location of the sphere with respect to the frustum.

Region cugl::Frustum::findSphere	(	float	x,
		float	y,
		float	z,
		float	radius
	)

inline

Returns the location of the sphere with respect to the frustum.

Parameters

x	The x-coordinate of the center of the sphere
y	The y-coordinate of the center of the sphere
z	The z-coordinate of the center of the sphere
radius	The radius of the sphere

Returns: the containment type of the sphere.

Region cugl::Frustum::findSphereWithoutNearFar	(	const Vec3 &	center,
		float	radius
	)

Returns the location of the sphere with respect to the frustum.

This method does not check whether is the behind the near or far clipping planes.

Parameters

center	The center of the sphere
radius	The radius of the sphere

Returns: the location of the sphere with respect to the frustum.

Region cugl::Frustum::findSphereWithoutNearFar	(	float	x,
		float	y,
		float	z,
		float	radius
	)

inline

Returns the location of the sphere with respect to the frustum.

This method does not check whether is the behind the near or far clipping planes.

Parameters

x	The x-coordinate of the center of the sphere
y	The y-coordinate of the center of the sphere
z	The z-coordinate of the center of the sphere
radius	The radius of the sphere

Returns: the location of the sphere with respect to the frustum.

const Vec3& cugl::Frustum::getCorner ( unsigned int index )

inline

Returns the frustum corner for the given index.

The order is counter clockwise, starting at bottom left

Returns: the frustum corner for the given index.

const Plane& cugl::Frustum::getPlane ( Side side )

inline

Returns the clipping plane for the given side.

See the enum Side for the available options.

Parameters

side	The clipping plane side.

Returns: the clipping plane for the given side.

Frustum& cugl::Frustum::operator= ( const Mat4 & inverseView )

inline

Sets this frustum's clipping planes to the given inverse projection view matrix.

Parameters

inverseView The inverse projection view matrix.

Returns: A reference to this (modified) Frustum for chaining.

Frustum& cugl::Frustum::operator= ( const Frustum & frustum )

inline

Sets this frustum to be a copy of the given frustum.

Parameters

frustum The frustum to copy,

Returns: A reference to this (modified) Frustum for chaining.

Frustum& cugl::Frustum::set ( const Mat4 & inverseView )

Sets this frustum's clipping planes to the given inverse projection view matrix.

Parameters

inverseView The inverse projection view matrix.

Returns: A reference to this (modified) Frustum for chaining.

Frustum& cugl::Frustum::set ( const Frustum & frustum )

Sets this frustum to be a copy of the given frustum.

Parameters

frustum The frustum to copy,

Returns: A reference to this (modified) Frustum for chaining.

Member Data Documentation

const int cugl::Frustum::CORNER_COUNT = 8

static

The number of corners in a frustum

const int cugl::Frustum::PLANE_COUNT = 6

static

The number of planes in a frustum

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

math/CUFrustum.h

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation