ogrecapsule.h

opcode是功能强大

///////////////////////////////////////////////////////////////////////////////
///  @file OgreCapsule.h
///  @brief This class represents a Capsule, which is defined by 2 endpoints and a radius.
///			You can interpret it as a sphere that is sweept along a line.
///
///  @author The OgreOpcode Team @date 23-02-2005
///
///////////////////////////////////////////////////////////////////////////////
///
///  This file is part of OgreOpcode.
///
///  A lot of the code is based on the Nebula Opcode Collision module, see docs/Nebula_license.txt
///
///  OgreOpcode is free software; you can redistribute it and/or
///  modify it under the terms of the GNU Lesser General Public
///  License as published by the Free Software Foundation; either
///  version 2.1 of the License, or (at your option) any later version.
///
///  OgreOpcode is distributed in the hope that it will be useful,
///  but WITHOUT ANY WARRANTY; without even the implied warranty of
///  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
///  Lesser General Public License for more details.
///
///  You should have received a copy of the GNU Lesser General Public
///  License along with OgreOpcode; if not, write to the Free Software
///  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
///
///////////////////////////////////////////////////////////////////////////////
#ifndef __OgreOpcodeCapsule_h__
#define __OgreOpcodeCapsule_h__

#include "OgreOpcodeLine.h"

namespace OgreOpcode
{
	namespace Details
    {
		/// Represents a Capsule defined by 2 endpoints and a radius
		/// TODO: add methods to this capsule.
		class _OgreOpcode_Export Capsule
		{
		public:

			/** Default constructor: degenerated as an unitary sphere at origin
			 */
			Capsule():start(),end(),radius(1.0)
			{
			}

			/** Copy-constructor
			 */
			Capsule(const Capsule& c):start(c.start),end(c.end),radius(c.radius)
			{
			}

			/** Complete constructor
			 */
			Capsule(const Ogre::Vector3& s, const Ogre::Vector3& e, Ogre::Real r ):start(s),end(e),radius(r)
			{
			}

			/** Complete, headache constructor
			 */
			Capsule( Ogre::Real sx, Ogre::Real sy, Ogre::Real sz,
				     Ogre::Real ex, Ogre::Real ey, Ogre::Real ez,
					 Ogre::Real r
				   ):start(sx,sy,sz),end(ex,ey,ez),radius(r)
			{
			}

			/// Gets the length of this line segment
			Ogre::Real length() const {  return (start - end).length(); }
			/// Gets the squared length of this line segment
			Ogre::Real length2() const {  return (start - end).squaredLength(); }

			/// Gets the surface area of this capsule
			Ogre::Real area() const
			{
				return Ogre::Math::TWO_PI*radius*(2.0*radius + length() );
			}

			/// Gets the volume are this capsule
			Ogre::Real volume() const
			{
				return Ogre::Math::PI*radius*radius*( 1.333333333333333*length() );
			}
// --------------------------------------------------------------------
// intersection tests

			/** Does this capsule contain the given point?
			 */
			bool contains( const Ogre::Vector3& point ) const;

			/** Tests intersection between this capsule and the given Axis-Aligned
			 *  Bounding Box
             */
			bool intersects( const Aabb& aabb ) const;

			/** Tests intersection between this capsule and the given sphere
			 */
			bool intersects( const sphere& s ) const;

			/** Tests intersection between this capsule and the given Oriented Bounding Box
			 */
			bool intersects( const OrientedBox& obb ) const;

			/** Tests intersection between this capsule and the given one
			 */
			bool intersects( const Capsule& cap ) const;


			/** The start point of this capsule.
			 */
			Ogre::Vector3 start;
			/** The end point of this capsule.
			 */
			Ogre::Vector3 end;
			/** The radius of this capsule.
			 */
			Ogre::Real radius;
		};
	}
}

#endif