decDCollisionCylinder Class Reference

Cylinder Collision Volume. More...

#include <decDCollisionCylinder.h>

Inheritance diagram for decDCollisionCylinder:

List of all members.

Public Member Functions
Constructors and Destructors
	decDCollisionCylinder ()
	Creates a new unoriented cylinder.
	decDCollisionCylinder (const decDVector &position, double halfHeight, double topRadius, double bottomRadius)
	Creates a new unoriented cylinder.
	decDCollisionCylinder (const decDVector &position, double halfHeight, double topRadius, double bottomRadius, const decQuaternion &orientation)
	Creates a new oriented cylinder.
virtual	~decDCollisionCylinder ()
	Cleans up the collision Cylinder.
First Stage Dispatch
virtual bool	VolumeHitsVolume (decDCollisionVolume *volume)
	Determines if this volume collides with the given one.
virtual double	VolumeMoveHitsVolume (decDCollisionVolume *volume, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits another one.
Second Stage Dispatch
virtual bool	SphereHitsVolume (decDCollisionSphere *sphere)
	Determines if the given sphere collides with this volume.
virtual bool	CylinderHitsVolume (decDCollisionCylinder *Cylinder)
	Determines if the given cylinder collides with this volume.
virtual bool	CapsuleHitsVolume (decDCollisionCapsule *capsule)
	Determines if the given capsule collides with this volume.
virtual bool	BoxHitsVolume (decDCollisionBox *box)
	Determines if the given box collides with this volume.
virtual bool	TriangleHitsVolume (decDCollisionTriangle *triangle)
	Determines if the given triangle collides with this volume.
virtual bool	FrustumHitsVolume (decDCollisionFrustum *frustum)
	Determines if the given frustum collides with this volume.
virtual double	SphereMoveHitsVolume (decDCollisionSphere *sphere, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a sphere.
virtual double	CylinderMoveHitsVolume (decDCollisionCylinder *Cylinder, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a cylinder.
virtual double	CapsuleMoveHitsVolume (decDCollisionCapsule *capsule, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a capsule.
virtual double	BoxMoveHitsVolume (decDCollisionBox *box, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a box.
virtual double	TriangleMoveHitsVolume (decDCollisionTriangle *triangle, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a triangle.
virtual double	FrustumMoveHitsVolume (decDCollisionFrustum *frustum, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until this volume hits a frustum.
virtual double	PointMoveHitsVolume (const decDVector &point, const decDVector &displacement, decDVector *normal)
	Retrieves the distance travelled along a given displacement vector until the given point hits this volume.
Enclosing Volumes
virtual void	GetEnclosingSphere (decDCollisionSphere *sphere)
	Retrieves the sphere volume best enclosing this volume.
virtual void	GetEnclosingBox (decDCollisionBox *box)
	Retrieves the box volume best enclosing this volume.
Miscelanous Functions
virtual decDVector	ClosestPointTo (const decDVector &point)
	Retrieves the closest point on the volume.
virtual decDVector	NormalAtPoint (const decDVector &point)
	Retrieves the surface normal through the given point.
virtual bool	RayHitsVolume (const decDVector &rayOrigin, const decDVector &rayDirection, double &hitDistance)
	Determines if a ray hits the volume.
Visiting
virtual void	Visit (decDCollisionVolumeVisitor *visitor)
	Visits the collision volume.
Collision Routines
bool	SphereHitsCylinder (decDCollisionSphere *sphere)
	Determines if the given sphere collides with this Cylinder.
bool	CylinderHitsCylinder (decDCollisionCylinder *Cylinder)
	Determines if the given Cylinder collides with this Cylinder.
double	SphereMoveHitsCylinder (decDCollisionSphere *sphere, const decDVector &displacement, decDVector *normal)
	Determines the distance of the given sphere to move until colliding with this Cylinder.
double	CylinderMoveHitsCylinder (decDCollisionCylinder *Cylinder, const decDVector &displacement, decDVector *normal)
	Determines the distance of the given Cylinder to move until colliding with this Cylinder.
Management
const decDVector &	GetPosition () const
	Retrieves the cylinder center.
void	SetPosition (const decDVector &position)
	Sets the position.
const decQuaternion &	GetOrientation () const
	Retrieves the orientation.
void	SetOrientation (const decQuaternion &orientation)
	Sets the orientation.
void	ClearOrientation ()
	Clears the orientation of the cylinder setting it to the identity quaternion.
double	GetHalfHeight () const
	Retrieves the half height.
void	SetHalfHeight (double halfHeight)
	Sets the half height.
double	GetTopRadius () const
	Retrieves the top radius.
void	SetTopRadius (double radius)
	Sets the top radius.
double	GetBottomRadius () const
	Retrieves the bottom radius.
void	SetBottomRadius (double radius)
	Sets the bottom radius.
void	SetRadius (double radius)
	Sets both radi to the same value.
bool	GetOriented () const
	Determines if this cylinder is oriented.
bool	GetAxisAligned () const
	Determines if this cylinder is axis aligned.
bool	GetTapered () const
	Determines if this cylinder is tapered.
const decDVector &	GetAxisX () const
	Retrieves the X-Axis.
const decDVector &	GetAxisY () const
	Retrieves the Y-Axis.
const decDVector &	GetAxisZ () const
	Retrieves the Z-Axis.
decDVector	WorldToLocal (const decDVector &point) const
	Transforms a point from world coordinates into local coordinates.
decDVector	LocalToWorld (const decDVector &point) const
	Transforms a point from local coordinates into world coordinates.
decDVector	NormalWorldToLocal (const decDVector &normal) const
	Transforms a normal from world coordinates into local coordinates.
decDVector	NormalLocalToWorld (const decDVector &normal) const
	Transforms a normal from local coordinates into world coordinates.

---

Detailed Description

Cylinder Collision Volume.

Defines a collision volumed in the shape of a cylinder. The cylinder is defined by a half height and two radi one for the top circle and one for the bottom circle. The cylinder is oriented along the Y-Axis. A cylinder with different radi is a tapered cylinder while a cylinder with two identical radi is a common cylinder. Common cylinders are usually faster.

Author:

Plüss Roland

Version:

1.0

Date:

2008

Warning:

Partially implemented, see function notes

---

Constructor & Destructor Documentation

decDCollisionCylinder::decDCollisionCylinder

(

)

Creates a new unoriented cylinder.

The half height is set to 0.5, the top and bottom radius are set both to 0.5 too.

decDCollisionCylinder::decDCollisionCylinder	(	const decDVector &	position,
		double	halfHeight,
		double	topRadius,
		double	bottomRadius
	)

Creates a new unoriented cylinder.

Parameters:

position	Center of the cylinder.
halfHeight	Half the height of the cylinder. Has to be greater than 0.
topRadius	Radius of the top cap. Has to be greater than 0.
bottomRadius	Radius of the bottom cap. Has to be greater than 0.

decDCollisionCylinder::decDCollisionCylinder	(	const decDVector &	position,
		double	halfHeight,
		double	topRadius,
		double	bottomRadius,
		const decQuaternion &	orientation
	)

Creates a new oriented cylinder.

Parameters:

position	Center of the cylinder.
halfHeight	Half the height of the cylinder. Has to be greater than 0.
topRadius	Radius of the top cap. Has to be greater than 0.
bottomRadius	Radius of the bottom cap. Has to be greater than 0.
orientation	Orientation of the cylinder as normalized quaternion.

virtual decDCollisionCylinder::~decDCollisionCylinder

(

)

[virtual]

Cleans up the collision Cylinder.

---

Member Function Documentation

virtual bool decDCollisionCylinder::BoxHitsVolume

(

decDCollisionBox *

box )

[virtual]

Determines if the given box collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual double decDCollisionCylinder::BoxMoveHitsVolume	(	decDCollisionBox *	box,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a box.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual bool decDCollisionCylinder::CapsuleHitsVolume

(

decDCollisionCapsule *

capsule )

[virtual]

Determines if the given capsule collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual double decDCollisionCylinder::CapsuleMoveHitsVolume	(	decDCollisionCapsule *	capsule,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a capsule.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

void decDCollisionCylinder::ClearOrientation

(

)

Clears the orientation of the cylinder setting it to the identity quaternion.

virtual decDVector decDCollisionCylinder::ClosestPointTo

(

const decDVector &

point )

[virtual]

Retrieves the closest point on the volume.

Implements decDCollisionVolume.

bool decDCollisionCylinder::CylinderHitsCylinder

(

decDCollisionCylinder *

Cylinder )

Determines if the given Cylinder collides with this Cylinder.

Warning:

Function is not implemented yet and always returns false.

virtual bool decDCollisionCylinder::CylinderHitsVolume

(

decDCollisionCylinder *

cylinder )

[virtual]

Determines if the given cylinder collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

double decDCollisionCylinder::CylinderMoveHitsCylinder	(	decDCollisionCylinder *	Cylinder,
		const decDVector &	displacement,
		decDVector *	normal
	)

Determines the distance of the given Cylinder to move until colliding with this Cylinder.

Warning:

Function is not implemented yet and always returns 1.

virtual double decDCollisionCylinder::CylinderMoveHitsVolume	(	decDCollisionCylinder *	cylinder,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a cylinder.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual bool decDCollisionCylinder::FrustumHitsVolume

(

decDCollisionFrustum *

frustum )

[virtual]

Determines if the given frustum collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual double decDCollisionCylinder::FrustumMoveHitsVolume	(	decDCollisionFrustum *	frustum,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a frustum.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

bool decDCollisionCylinder::GetAxisAligned

(

)

const [inline]

Determines if this cylinder is axis aligned.

Returns:

True if the cylinder has an orientation equal to the identity quaternion.

const decDVector& decDCollisionCylinder::GetAxisX

(

)

const [inline]

Retrieves the X-Axis.

Returns:

Normalized vector along the X-Axis.

const decDVector& decDCollisionCylinder::GetAxisY

(

)

const [inline]

Retrieves the Y-Axis.

Returns:

Normalized vector along the Y-Axis.

const decDVector& decDCollisionCylinder::GetAxisZ

(

)

const [inline]

Retrieves the Z-Axis.

Returns:

Normalized vector along the Z-Axis.

double decDCollisionCylinder::GetBottomRadius

(

)

const [inline]

Retrieves the bottom radius.

virtual void decDCollisionCylinder::GetEnclosingBox

(

decDCollisionBox *

box )

[virtual]

Retrieves the box volume best enclosing this volume.

Implements decDCollisionVolume.

virtual void decDCollisionCylinder::GetEnclosingSphere

(

decDCollisionSphere *

sphere )

[virtual]

Retrieves the sphere volume best enclosing this volume.

Implements decDCollisionVolume.

double decDCollisionCylinder::GetHalfHeight

(

)

const [inline]

Retrieves the half height.

const decQuaternion& decDCollisionCylinder::GetOrientation

(

)

const [inline]

Retrieves the orientation.

bool decDCollisionCylinder::GetOriented

(

)

const [inline]

Determines if this cylinder is oriented.

Returns:

True if the cylinder has an orientation other than the identity quaternion.

const decDVector& decDCollisionCylinder::GetPosition

(

)

const [inline]

Retrieves the cylinder center.

bool decDCollisionCylinder::GetTapered

(

)

const [inline]

Determines if this cylinder is tapered.

Returns:

True if the top and bottom radius are not identical.

double decDCollisionCylinder::GetTopRadius

(

)

const [inline]

Retrieves the top radius.

decDVector decDCollisionCylinder::LocalToWorld

(

const decDVector &

point )

const

Transforms a point from local coordinates into world coordinates.

virtual decDVector decDCollisionCylinder::NormalAtPoint

(

const decDVector &

point )

[virtual]

Retrieves the surface normal through the given point.

The point is either right on the surface or near to it. This function is relaxing in this case and tries to calculate the best normal pointing from the volume at the point. For certain points a normal is impossible to determine. The normal in this case is undefined.

Parameters:

point

Point to determine the normal for.

Returns:

Surface normal at given point.

Reimplemented from decDCollisionVolume.

decDVector decDCollisionCylinder::NormalLocalToWorld

(

const decDVector &

normal )

const

Transforms a normal from local coordinates into world coordinates.

decDVector decDCollisionCylinder::NormalWorldToLocal

(

const decDVector &

normal )

const

Transforms a normal from world coordinates into local coordinates.

virtual double decDCollisionCylinder::PointMoveHitsVolume	(	const decDVector &	point,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until the given point hits this volume.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual bool decDCollisionCylinder::RayHitsVolume	(	const decDVector &	rayOrigin,
		const decDVector &	rayDirection,
		double &	hitDistance
	)		[virtual]

Determines if a ray hits the volume.

Parameters:

rayOrigin	Origin of the ray.
rayDirection	Normalized direction of the ray.
hitDistance	If the ray hits this will be set to the distance from the ray origin to the collision point.

Returns:

True if the ray hits the volume.

Reimplemented from decDCollisionVolume.

void decDCollisionCylinder::SetBottomRadius

(

double

radius )

Sets the bottom radius.

Parameters:

radius

Radius of the bottom cylinder cap. Has to be greater than 0.

void decDCollisionCylinder::SetHalfHeight

(

double

halfHeight )

Sets the half height.

Parameters:

halfHeight

Half the height of the cylinder. Has to be greater than 0.

void decDCollisionCylinder::SetOrientation

(

const decQuaternion &

orientation )

Sets the orientation.

Parameters:

orientation

Normalized rotation quaternion.

void decDCollisionCylinder::SetPosition

(

const decDVector &

position )

Sets the position.

Parameters:

position

Center of cylinder.

void decDCollisionCylinder::SetRadius

(

double

radius )

Sets both radi to the same value.

Parameters:

radius

Radius of both the top and bottom cap. Has to be greater than 0.

void decDCollisionCylinder::SetTopRadius

(

double

radius )

Sets the top radius.

Parameters:

radius

Radius of the top cylinder cap. Has to be greater than 0.

bool decDCollisionCylinder::SphereHitsCylinder

(

decDCollisionSphere *

sphere )

Determines if the given sphere collides with this Cylinder.

Warning:

Function is not implemented yet and always returns false.

virtual bool decDCollisionCylinder::SphereHitsVolume

(

decDCollisionSphere *

sphere )

[virtual]

Determines if the given sphere collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

double decDCollisionCylinder::SphereMoveHitsCylinder	(	decDCollisionSphere *	sphere,
		const decDVector &	displacement,
		decDVector *	normal
	)

Determines the distance of the given sphere to move until colliding with this Cylinder.

Warning:

Function is not implemented yet and always returns 1.

virtual double decDCollisionCylinder::SphereMoveHitsVolume	(	decDCollisionSphere *	sphere,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a sphere.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual bool decDCollisionCylinder::TriangleHitsVolume

(

decDCollisionTriangle *

triangle )

[virtual]

Determines if the given triangle collides with this volume.

The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual double decDCollisionCylinder::TriangleMoveHitsVolume	(	decDCollisionTriangle *	triangle,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits a triangle.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a collision function here.

Implements decDCollisionVolume.

virtual void decDCollisionCylinder::Visit

(

decDCollisionVolumeVisitor *

visitor )

[virtual]

Visits the collision volume.

Implements decDCollisionVolume.

virtual bool decDCollisionCylinder::VolumeHitsVolume

(

decDCollisionVolume *

volume )

[virtual]

Determines if this volume collides with the given one.

The subclass has to dispatch to a second stage function here.

Implements decDCollisionVolume.

virtual double decDCollisionCylinder::VolumeMoveHitsVolume	(	decDCollisionVolume *	volume,
		const decDVector &	displacement,
		decDVector *	normal
	)		[virtual]

Retrieves the distance travelled along a given displacement vector until this volume hits another one.

The returned value is in the range of 0 to 1. If no collision happens 1 is returned. In case of collision 'normal' has to be filled in with a normalized vector designating the plane along which this volume can be moved without colliding the given volume. Set 'normal' to NULL if you are not interested in this information. The subclass has to dispatch to a second stage function here.

Implements decDCollisionVolume.

decDVector decDCollisionCylinder::WorldToLocal

(

const decDVector &

point )

const

Transforms a point from world coordinates into local coordinates.

---

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

• decDCollisionCylinder.h