dart
OdeCollisionDetector.hpp
1 /*
2  * Copyright (c) 2011-2021, The DART development contributors
3  * All rights reserved.
4  *
5  * The list of contributors can be found at:
6  * https://github.com/dartsim/dart/blob/master/LICENSE
7  *
8  * This file is provided under the following "BSD-style" License:
9  * Redistribution and use in source and binary forms, with or
10  * without modification, are permitted provided that the following
11  * conditions are met:
12  * * Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * * Redistributions in binary form must reproduce the above
15  * copyright notice, this list of conditions and the following
16  * disclaimer in the documentation and/or other materials provided
17  * with the distribution.
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
19  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
20  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
26  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
29  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef DART_COLLISION_ODE_ODECOLLISIONDETECTOR_HPP_
34 #define DART_COLLISION_ODE_ODECOLLISIONDETECTOR_HPP_
35 
36 #include <ode/ode.h>
37 
38 #include "dart/dynamics/CollisionDetector.hpp"
39 
40 #define MAX_COLLIDE_RETURNS 250
41 
42 namespace dart {
43 namespace collision {
44 
53 {
54 public:
56 
57  friend class OdeCollisionObject;
58 
59  static std::shared_ptr<OdeCollisionDetector> create();
60 
62  virtual ~OdeCollisionDetector();
63 
64  // Documentation inherited
65  std::shared_ptr<CollisionDetector> cloneWithoutCollisionObjects()
66  const override;
67 
68  // Documentation inherited
69  const std::string& getType() const override;
70 
72  static const std::string& getStaticType();
73 
74  // Documentation inherited
75  std::unique_ptr<CollisionGroup> createCollisionGroup() override;
76 
77  // Documentation inherited
78  bool collide(
79  CollisionGroup* group,
80  const CollisionOption& option = CollisionOption(false, 1u, nullptr),
81  CollisionResult* result = nullptr) override;
82 
83  // Documentation inherited
84  bool collide(
85  CollisionGroup* group1,
86  CollisionGroup* group2,
87  const CollisionOption& option = CollisionOption(false, 1u, nullptr),
88  CollisionResult* result = nullptr) override;
89 
91  double distance(
92  CollisionGroup* group,
93  const DistanceOption& option = DistanceOption(false, 0.0, nullptr),
94  DistanceResult* result = nullptr) override;
95 
97  double distance(
98  CollisionGroup* group1,
99  CollisionGroup* group2,
100  const DistanceOption& option = DistanceOption(false, 0.0, nullptr),
101  DistanceResult* result = nullptr) override;
102 
103 protected:
106 
107  // Documentation inherited
108  std::unique_ptr<CollisionObject> createCollisionObject(
109  const dynamics::ShapeFrame* shapeFrame) override;
110 
111  // Documentation inherited
112  void refreshCollisionObject(CollisionObject* object) override;
113 
114  dWorldID getOdeWorldId() const;
115 
116 protected:
118  dWorldID mWorldId;
119 
120 private:
121  dGeomID createOdeCollisionGeometry(const dynamics::ConstShapePtr& shape);
122 
123 private:
124  dContactGeom contactCollisions[MAX_COLLIDE_RETURNS];
125  static Registrar<OdeCollisionDetector> mRegistrar;
126 };
127 
128 } // namespace collision
129 } // namespace dart
130 
131 #endif // DART_COLLISION_ODE_ODECOLLISIONDETECTOR_HPP_
void refreshCollisionObject(CollisionObject *object) override
Update the collision geometry of a ShapeFrame.
Definition: OdeCollisionDetector.cpp:238
OdeCollisionDetector()
Constructor.
Definition: OdeCollisionDetector.cpp:216
std::unique_ptr< CollisionObject > createCollisionObject(const dynamics::ShapeFrame *shapeFrame) override
Create CollisionObject.
Definition: OdeCollisionDetector.cpp:230
std::shared_ptr< CollisionDetector > cloneWithoutCollisionObjects() const override
Create a clone of this CollisionDetector.
Definition: OdeCollisionDetector.cpp:126
Definition: DistanceResult.hpp:46
std::unique_ptr< CollisionGroup > createCollisionGroup() override
Create a collision group.
Definition: OdeCollisionDetector.cpp:145
bool collide(CollisionGroup *group, const CollisionOption &option=CollisionOption(false, 1u, nullptr), CollisionResult *result=nullptr) override
Perform collision check for a single group.
Definition: OdeCollisionDetector.cpp:151
Definition: Aspect.cpp:40
Definition: CollisionOption.hpp:44
const std::string & getType() const override
Return collision detection engine type as a std::string.
Definition: OdeCollisionDetector.cpp:132
dWorldID mWorldId
Top-level world for all bodies.
Definition: OdeCollisionDetector.hpp:118
virtual ~OdeCollisionDetector()
Constructor.
Definition: OdeCollisionDetector.cpp:116
Definition: CollisionResult.hpp:51
Definition: DistanceOption.hpp:44
Definition: DARTCollide.cpp:90
Definition: CollisionObject.hpp:43
Definition: CollisionGroup.hpp:51
Definition: OdeCollisionObject.hpp:48
double distance(CollisionGroup *group, const DistanceOption &option=DistanceOption(false, 0.0, nullptr), DistanceResult *result=nullptr) override
Definition: OdeCollisionDetector.cpp:193
Definition: ShapeFrame.hpp:189
static const std::string & getStaticType()
Get collision detector type for this class.
Definition: OdeCollisionDetector.cpp:138
OdeCollisionDetector wraps the ODE collision detector.
Definition: OdeCollisionDetector.hpp:52
Definition: CollisionDetector.hpp:56
virtual std::unique_ptr< CollisionGroup > createCollisionGroup()=0
Create a collision group.