[9890] | 1 | /*! |
---|
| 2 | * @file collision_tube.h |
---|
| 3 | * |
---|
| 4 | * collision tube collects all collisions from all entities |
---|
[9892] | 5 | * |
---|
| 6 | * The collision events are saved in the _collisionList vector in a fixed hirarchy: a collision is defined by the world entities |
---|
| 7 | * that collide. For each collision there is an entry in _collisionList. Each collision itself again contains collision events which are |
---|
| 8 | * defined as collisions between the boundibg volumes (BV) of the world entities. This could look like this: |
---|
| 9 | * |
---|
| 10 | * - Collision (WorldEntity_i <=> WorldEntity_j) |
---|
| 11 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 12 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 13 | * - Collision (WorldEntity_k <=> WorldEntity_l) |
---|
| 14 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 15 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 16 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 17 | * +- CollisionEvent( some BV <=> some other BV) |
---|
| 18 | * - ... etc ... |
---|
| 19 | * |
---|
| 20 | * |
---|
| 21 | * When the collisions are processed by the handleCollision() function each collision pair is checked for their reactions (since each |
---|
| 22 | * WorldEntity can define several reactions to a collision). After all the reactions are calculated and applied the collision object is |
---|
| 23 | * put back. |
---|
[9890] | 24 | */ |
---|
| 25 | |
---|
| 26 | #ifndef _COLLISION_TUBE_H |
---|
| 27 | #define _COLLISION_TUBE_H |
---|
| 28 | |
---|
| 29 | #include "base_object.h" |
---|
| 30 | #include "cr_engine.h" |
---|
| 31 | #include "world_entity.h" |
---|
| 32 | |
---|
| 33 | #include "vector.h" |
---|
| 34 | #include <vector> |
---|
| 35 | |
---|
| 36 | class Collision; |
---|
| 37 | class WorldEntity; |
---|
| 38 | class BoundingVolume; |
---|
| 39 | |
---|
| 40 | namespace CoRe |
---|
| 41 | { |
---|
| 42 | |
---|
| 43 | class CollisionReaction; |
---|
| 44 | |
---|
[9892] | 45 | //! A class containing all CollisionEvents (structured as defined in the file doxygen tags) |
---|
[9890] | 46 | class CollisionTube : public BaseObject |
---|
| 47 | { |
---|
| 48 | ObjectListDeclaration(CollisionTube); |
---|
| 49 | |
---|
| 50 | public: |
---|
[9892] | 51 | virtual ~CollisionTube(); |
---|
[9890] | 52 | |
---|
[9896] | 53 | inline static CollisionTube* getInstance() { if( CollisionTube::instance != NULL) CollisionTube::instance = new CollisionTube(); return CollisionTube::instance; } |
---|
| 54 | |
---|
[9890] | 55 | /** @returns true if at least one of both WorldEntities are subscribed for a collision check */ |
---|
| 56 | inline bool isReactive(const WorldEntity& entityA, const WorldEntity& entityB) const |
---|
| 57 | { return (entityA.isReactive() && entityB.isReactive()); } |
---|
[9893] | 58 | bool needCollisionChecking(const WorldEntity& entityA, const WorldEntity& entityB); |
---|
[9890] | 59 | |
---|
[9891] | 60 | void registerCollisionEvent(WorldEntity* entityA, WorldEntity* entityB, BoundingVolume* bvA, BoundingVolume* bvB); |
---|
[9893] | 61 | void registerCollisionEvent(CREngine::CollisionType type, WorldEntity* entity, WorldEntity* groundEntity, |
---|
[9890] | 62 | const Vector& normal, const Vector& position, bool bInWall = false); |
---|
| 63 | |
---|
| 64 | void handleCollisions(); |
---|
| 65 | |
---|
| 66 | |
---|
| 67 | private: |
---|
[9896] | 68 | /* private std constructor since this is a singleton class */ |
---|
| 69 | CollisionTube(); |
---|
[9890] | 70 | /* private copy constructor so this object can't be passed as a */ |
---|
| 71 | CollisionTube(const CollisionTube& tube) {} |
---|
| 72 | |
---|
| 73 | |
---|
| 74 | private: |
---|
| 75 | std::vector<Collision*> _collisionList; //!< the list of collisions since the last processing |
---|
| 76 | |
---|
[9896] | 77 | static CollisionTube* instance; //!< the singleton instance |
---|
[9890] | 78 | }; |
---|
| 79 | |
---|
| 80 | } |
---|
| 81 | |
---|
| 82 | #endif /* _COLLISION_TUBE_H */ |
---|