186 lines
11 KiB
C
186 lines
11 KiB
C
|
/*
|
||
|
|
* OPCODE - Optimized Collision Detection
|
||
|
|
* http://www.codercorner.com/Opcode.htm
|
||
|
|
*
|
||
|
|
* Copyright (c) 2001-2008 Pierre Terdiman, pierre@codercorner.com
|
||
|
|
|
||
|
|
This software is provided 'as-is', without any express or implied warranty.
|
||
|
|
In no event will the authors be held liable for any damages arising from the use of this software.
|
||
|
|
Permission is granted to anyone to use this software for any purpose,
|
||
|
|
including commercial applications, and to alter it and redistribute it freely,
|
||
|
|
subject to the following restrictions:
|
||
|
|
|
||
|
|
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
|
||
|
|
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
|
||
|
|
3. This notice may not be removed or altered from any source distribution.
|
||
|
|
*/
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Contains base collider class.
|
||
|
|
* \file OPC_Collider.h
|
||
|
|
* \author Pierre Terdiman
|
||
|
|
* \date June, 2, 2001
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
// Include Guard
|
||
|
|
#ifndef __OPC_COLLIDER_H__
|
||
|
|
#define __OPC_COLLIDER_H__
|
||
|
|
|
||
|
|
enum CollisionFlag
|
||
|
|
{
|
||
|
|
OPC_FIRST_CONTACT = (1<<0), //!< Report all contacts (false) or only first one (true)
|
||
|
|
OPC_TEMPORAL_COHERENCE = (1<<1), //!< Use temporal coherence or not
|
||
|
|
OPC_CONTACT = (1<<2), //!< Final contact status after a collision query
|
||
|
|
OPC_TEMPORAL_HIT = (1<<3), //!< There has been an early exit due to temporal coherence
|
||
|
|
OPC_NO_PRIMITIVE_TESTS = (1<<4), //!< Keep or discard primitive-bv tests in leaf nodes (volume-mesh queries)
|
||
|
|
|
||
|
|
OPC_CONTACT_FOUND = OPC_FIRST_CONTACT | OPC_CONTACT,
|
||
|
|
OPC_TEMPORAL_CONTACT = OPC_TEMPORAL_HIT | OPC_CONTACT,
|
||
|
|
|
||
|
|
OPC_FORCE_DWORD = 0x7fffffff
|
||
|
|
};
|
||
|
|
|
||
|
|
class OPCODE_API Collider
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
// Constructor / Destructor
|
||
|
|
Collider();
|
||
|
|
virtual ~Collider();
|
||
|
|
|
||
|
|
// Collision report
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Gets the last collision status after a collision query.
|
||
|
|
* \return true if a collision occured
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL GetContactStatus() const { return mFlags & OPC_CONTACT; }
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Gets the "first contact" mode.
|
||
|
|
* \return true if "first contact" mode is on
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL FirstContactEnabled() const { return mFlags & OPC_FIRST_CONTACT; }
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Gets the temporal coherence mode.
|
||
|
|
* \return true if temporal coherence is on
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL TemporalCoherenceEnabled() const { return mFlags & OPC_TEMPORAL_COHERENCE; }
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Checks a first contact has already been found.
|
||
|
|
* \return true if a first contact has been found and we can stop a query
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL ContactFound() const { return (mFlags&OPC_CONTACT_FOUND)==OPC_CONTACT_FOUND; }
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Checks there's been an early exit due to temporal coherence;
|
||
|
|
* \return true if a temporal hit has occured
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL TemporalHit() const { return mFlags & OPC_TEMPORAL_HIT; }
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Checks primitive tests are enabled;
|
||
|
|
* \return true if primitive tests must be skipped
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL SkipPrimitiveTests() const { return mFlags & OPC_NO_PRIMITIVE_TESTS; }
|
||
|
|
|
||
|
|
// Settings
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Reports all contacts (false) or first contact only (true)
|
||
|
|
* \param flag [in] true for first contact, false for all contacts
|
||
|
|
* \see SetTemporalCoherence(bool flag)
|
||
|
|
* \see ValidateSettings()
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ void SetFirstContact(bool flag)
|
||
|
|
{
|
||
|
|
if(flag) mFlags |= OPC_FIRST_CONTACT;
|
||
|
|
else mFlags &= ~OPC_FIRST_CONTACT;
|
||
|
|
}
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Enable/disable temporal coherence.
|
||
|
|
* \param flag [in] true to enable temporal coherence, false to discard it
|
||
|
|
* \see SetFirstContact(bool flag)
|
||
|
|
* \see ValidateSettings()
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ void SetTemporalCoherence(bool flag)
|
||
|
|
{
|
||
|
|
if(flag) mFlags |= OPC_TEMPORAL_COHERENCE;
|
||
|
|
else mFlags &= ~OPC_TEMPORAL_COHERENCE;
|
||
|
|
}
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Enable/disable primitive tests.
|
||
|
|
* \param flag [in] true to enable primitive tests, false to discard them
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ void SetPrimitiveTests(bool flag)
|
||
|
|
{
|
||
|
|
if(!flag) mFlags |= OPC_NO_PRIMITIVE_TESTS;
|
||
|
|
else mFlags &= ~OPC_NO_PRIMITIVE_TESTS;
|
||
|
|
}
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Validates current settings. You should call this method after all the settings / callbacks have been defined for a collider.
|
||
|
|
* \return null if everything is ok, else a string describing the problem
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
virtual const char* ValidateSettings() = 0;
|
||
|
|
|
||
|
|
protected:
|
||
|
|
udword mFlags; //!< Bit flags
|
||
|
|
const BaseModel* mCurrentModel; //!< Current model for collision query (owner of touched faces)
|
||
|
|
// User mesh interface
|
||
|
|
const MeshInterface* mIMesh; //!< User-defined mesh interface
|
||
|
|
|
||
|
|
// Internal methods
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Setups current collision model
|
||
|
|
* \param model [in] current collision model
|
||
|
|
* \return TRUE if success
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
inline_ BOOL Setup(const BaseModel* model)
|
||
|
|
{
|
||
|
|
// Keep track of current model
|
||
|
|
mCurrentModel = model;
|
||
|
|
if(!mCurrentModel) return FALSE;
|
||
|
|
|
||
|
|
mIMesh = model->GetMeshInterface();
|
||
|
|
return mIMesh!=null;
|
||
|
|
}
|
||
|
|
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
/**
|
||
|
|
* Initializes a query
|
||
|
|
*/
|
||
|
|
///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
|
virtual inline_ void InitQuery() { mFlags &= ~OPC_TEMPORAL_CONTACT; }
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif // __OPC_COLLIDER_H__
|