Bullet Collision Detection & Physics Library: btCylinderShape.h Source File

Bullet Collision Detection & Physics Library

- Main Page
- Namespaces
- Classes
- Files

- File List
- File Members

btCylinderShape.h
Go to the documentation of this file.
1/*
2Bullet Continuous Collision Detection and Physics Library
3Copyright (c) 2003-2009 Erwin Coumans http://bulletphysics.org
4
5This software is provided 'as-is', without any express or implied warranty.
6In no event will the authors be held liable for any damages arising from the use of this software.
7Permission is granted to anyone to use this software for any purpose,
8including commercial applications, and to alter it and redistribute it freely,
9subject to the following restrictions:
10
111. 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.
122. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
133. This notice may not be removed or altered from any source distribution.
14*/
15
16#ifndef BT_CYLINDER_MINKOWSKI_H
17#define BT_CYLINDER_MINKOWSKI_H
18
19#include "btBoxShape.h"
20#include "BulletCollision/BroadphaseCollision/btBroadphaseProxy.h" // for the types
21#include "LinearMath/btVector3.h"
22
24 ATTRIBUTE_ALIGNED16(class)
25 btCylinderShape : public btConvexInternalShape
26
27{
28protected:
29 int m_upAxis;
30
31public:
32 BT_DECLARE_ALIGNED_ALLOCATOR();
33
34 btVector3 getHalfExtentsWithMargin() const
35 {
36 btVector3 halfExtents = getHalfExtentsWithoutMargin();
37 btVector3 margin(getMargin(), getMargin(), getMargin());
38 halfExtents += margin;
39 return halfExtents;
40 }
41
42 const btVector3& getHalfExtentsWithoutMargin() const
43 {
44 return m_implicitShapeDimensions; //changed in Bullet 2.63: assume the scaling and margin are included
45 }
46
47 btCylinderShape(const btVector3& halfExtents);
48
49 void getAabb(const btTransform& t, btVector3& aabbMin, btVector3& aabbMax) const;
50
51 virtual void calculateLocalInertia(btScalar mass, btVector3 & inertia) const;
52
53 virtual btVector3 localGetSupportingVertexWithoutMargin(const btVector3& vec) const;
54
55 virtual void batchedUnitVectorGetSupportingVertexWithoutMargin(const btVector3* vectors, btVector3* supportVerticesOut, int numVectors) const;
56
57 virtual void setMargin(btScalar collisionMargin)
58 {
59 //correct the m_implicitShapeDimensions for the margin
60 btVector3 oldMargin(getMargin(), getMargin(), getMargin());
61 btVector3 implicitShapeDimensionsWithMargin = m_implicitShapeDimensions + oldMargin;
62
63 btConvexInternalShape::setMargin(collisionMargin);
64 btVector3 newMargin(getMargin(), getMargin(), getMargin());
65 m_implicitShapeDimensions = implicitShapeDimensionsWithMargin - newMargin;
66 }
67
68 virtual btVector3 localGetSupportingVertex(const btVector3& vec) const
69 {
70 btVector3 supVertex;
71 supVertex = localGetSupportingVertexWithoutMargin(vec);
72
73 if (getMargin() != btScalar(0.))
74 {
75 btVector3 vecnorm = vec;
76 if (vecnorm.length2() < (SIMD_EPSILON * SIMD_EPSILON))
77 {
78 vecnorm.setValue(btScalar(-1.), btScalar(-1.), btScalar(-1.));
79 }
80 vecnorm.normalize();
81 supVertex += getMargin() * vecnorm;
82 }
83 return supVertex;
84 }
85
86 //use box inertia
87 // virtual void calculateLocalInertia(btScalar mass,btVector3& inertia) const;
88
89 int getUpAxis() const
90 {
91 return m_upAxis;
92 }
93
94 virtual btVector3 getAnisotropicRollingFrictionDirection() const
95 {
96 btVector3 aniDir(0, 0, 0);
97 aniDir[getUpAxis()] = 1;
98 return aniDir;
99 }
100
101 virtual btScalar getRadius() const
102 {
103 return getHalfExtentsWithMargin().getX();
104 }
105
106 virtual void setLocalScaling(const btVector3& scaling)
107 {
108 btVector3 oldMargin(getMargin(), getMargin(), getMargin());
109 btVector3 implicitShapeDimensionsWithMargin = m_implicitShapeDimensions + oldMargin;
110 btVector3 unScaledImplicitShapeDimensionsWithMargin = implicitShapeDimensionsWithMargin / m_localScaling;
111
112 btConvexInternalShape::setLocalScaling(scaling);
113
114 m_implicitShapeDimensions = (unScaledImplicitShapeDimensionsWithMargin * m_localScaling) - oldMargin;
115 }
116
117 //debugging
118 virtual const char* getName() const
119 {
120 return "CylinderY";
121 }
122
123 virtual int calculateSerializeBufferSize() const;
124
126 virtual const char* serialize(void* dataBuffer, btSerializer* serializer) const;
127};
128
129 class btCylinderShapeX : public btCylinderShape
130{
131public:
132 BT_DECLARE_ALIGNED_ALLOCATOR();
133
134 btCylinderShapeX(const btVector3& halfExtents);
135
136 virtual btVector3 localGetSupportingVertexWithoutMargin(const btVector3& vec) const;
137 virtual void batchedUnitVectorGetSupportingVertexWithoutMargin(const btVector3* vectors, btVector3* supportVerticesOut, int numVectors) const;
138
139 //debugging
140 virtual const char* getName() const
141 {
142 return "CylinderX";
143 }
144
145 virtual btScalar getRadius() const
146 {
147 return getHalfExtentsWithMargin().getY();
148 }
149};
150
151 class btCylinderShapeZ : public btCylinderShape
152{
153public:
154 BT_DECLARE_ALIGNED_ALLOCATOR();
155
156 btCylinderShapeZ(const btVector3& halfExtents);
157
158 virtual btVector3 localGetSupportingVertexWithoutMargin(const btVector3& vec) const;
159 virtual void batchedUnitVectorGetSupportingVertexWithoutMargin(const btVector3* vectors, btVector3* supportVerticesOut, int numVectors) const;
160
161 //debugging
162 virtual const char* getName() const
163 {
164 return "CylinderZ";
165 }
166
167 virtual btScalar getRadius() const
168 {
169 return getHalfExtentsWithMargin().getX();
170 }
171};
172
174 struct btCylinderShapeData
175{
176 btConvexInternalShapeData m_convexInternalShapeData;
177
178 int m_upAxis;
179
180 char m_padding[4];
181};
182
183 SIMD_FORCE_INLINE int btCylinderShape::calculateSerializeBufferSize() const
184{
185 return sizeof(btCylinderShapeData);
186}
187
189 SIMD_FORCE_INLINE const char* btCylinderShape::serialize(void* dataBuffer, btSerializer* serializer) const
190{
191 btCylinderShapeData* shapeData = (btCylinderShapeData*)dataBuffer;
192
193 btConvexInternalShape::serialize(&shapeData->m_convexInternalShapeData, serializer);
194
195 shapeData->m_upAxis = m_upAxis;
196
197 // Fill padding with zeros to appease msan.
198 shapeData->m_padding[0] = 0;
199 shapeData->m_padding[1] = 0;
200 shapeData->m_padding[2] = 0;
201 shapeData->m_padding[3] = 0;
202
203 return "btCylinderShapeData";
204}
205
206#endif //BT_CYLINDER_MINKOWSKI_H
btBoxShape.h
btBroadphaseProxy.h
btScalar
float btScalar
The btScalar type abstracts floating point numbers, to easily switch between double and single floati...
Definition: btScalar.h:314
ATTRIBUTE_ALIGNED16
#define ATTRIBUTE_ALIGNED16(a)
Definition: btScalar.h:99
SIMD_FORCE_INLINE
#define SIMD_FORCE_INLINE
Definition: btScalar.h:98
SIMD_EPSILON
#define SIMD_EPSILON
Definition: btScalar.h:543
btVector3.h
btConvexInternalShape
The btConvexInternalShape is an internal base class, shared by most convex shape implementations.
Definition: btConvexInternalShape.h:30
btConvexInternalShape::setMargin
virtual void setMargin(btScalar margin)
Definition: btConvexInternalShape.h:102
btConvexInternalShape::serialize
virtual const char * serialize(void *dataBuffer, btSerializer *serializer) const
fills the dataBuffer and returns the struct name (and 0 on failure)
Definition: btConvexInternalShape.h:154
btConvexInternalShape::setLocalScaling
virtual void setLocalScaling(const btVector3 &scaling)
Definition: btConvexInternalShape.cpp:24
btCylinderShapeX
Definition: btCylinderShape.h:130
btCylinderShapeX::getRadius
virtual btScalar getRadius() const
Definition: btCylinderShape.h:145
btCylinderShapeX::getName
virtual const char * getName() const
Definition: btCylinderShape.h:140
btCylinderShapeX::localGetSupportingVertexWithoutMargin
virtual btVector3 localGetSupportingVertexWithoutMargin(const btVector3 &vec) const
Definition: btCylinderShape.cpp:217
btCylinderShapeX::BT_DECLARE_ALIGNED_ALLOCATOR
BT_DECLARE_ALIGNED_ALLOCATOR()
btCylinderShapeX::batchedUnitVectorGetSupportingVertexWithoutMargin
virtual void batchedUnitVectorGetSupportingVertexWithoutMargin(const btVector3 *vectors, btVector3 *supportVerticesOut, int numVectors) const
Definition: btCylinderShape.cpp:247
btCylinderShapeZ
Definition: btCylinderShape.h:152
btCylinderShapeZ::getRadius
virtual btScalar getRadius() const
Definition: btCylinderShape.h:167
btCylinderShapeZ::getName
virtual const char * getName() const
Definition: btCylinderShape.h:162
btCylinderShapeZ::BT_DECLARE_ALIGNED_ALLOCATOR
BT_DECLARE_ALIGNED_ALLOCATOR()
btCylinderShapeZ::batchedUnitVectorGetSupportingVertexWithoutMargin
virtual void batchedUnitVectorGetSupportingVertexWithoutMargin(const btVector3 *vectors, btVector3 *supportVerticesOut, int numVectors) const
Definition: btCylinderShape.cpp:239
btCylinderShapeZ::localGetSupportingVertexWithoutMargin
virtual btVector3 localGetSupportingVertexWithoutMargin(const btVector3 &vec) const
Definition: btCylinderShape.cpp:222
btCylinderShape
The btCylinderShape class implements a cylinder shape primitive, centered around the origin....
Definition: btCylinderShape.h:27
btCylinderShape::BT_DECLARE_ALIGNED_ALLOCATOR
BT_DECLARE_ALIGNED_ALLOCATOR()
btCylinderShape::serialize
virtual const char * serialize(void *dataBuffer, btSerializer *serializer) const
fills the dataBuffer and returns the struct name (and 0 on failure)
Definition: btCylinderShape.h:189
btCylinderShape::getAnisotropicRollingFrictionDirection
virtual btVector3 getAnisotropicRollingFrictionDirection() const
the getAnisotropicRollingFrictionDirection can be used in combination with setAnisotropicFriction See...
Definition: btCylinderShape.h:94
btCylinderShape::getUpAxis
int getUpAxis() const
Definition: btCylinderShape.h:89
btCylinderShape::m_upAxis
int m_upAxis
Definition: btCylinderShape.h:29
btCylinderShape::getRadius
virtual btScalar getRadius() const
Definition: btCylinderShape.h:101
btCylinderShape::getHalfExtentsWithoutMargin
const btVector3 & getHalfExtentsWithoutMargin() const
Definition: btCylinderShape.h:42
btCylinderShape::setMargin
virtual void setMargin(btScalar collisionMargin)
Definition: btCylinderShape.h:57
btCylinderShape::calculateSerializeBufferSize
virtual int calculateSerializeBufferSize() const
Definition: btCylinderShape.h:183
btCylinderShape::getName
virtual const char * getName() const
Definition: btCylinderShape.h:118
btCylinderShape::localGetSupportingVertex
virtual btVector3 localGetSupportingVertex(const btVector3 &vec) const
Definition: btCylinderShape.h:68
btCylinderShape::getHalfExtentsWithMargin
btVector3 getHalfExtentsWithMargin() const
Definition: btCylinderShape.h:34
btCylinderShape::setLocalScaling
virtual void setLocalScaling(const btVector3 &scaling)
Definition: btCylinderShape.h:106
btSerializer
Definition: btSerializer.h:66
btTransform
The btTransform class supports rigid transforms with only translation and rotation and no scaling/she...
Definition: btTransform.h:30
btVector3
btVector3 can be used to represent 3D points and vectors.
Definition: btVector3.h:82
btVector3::setValue
void setValue(const btScalar &_x, const btScalar &_y, const btScalar &_z)
Definition: btVector3.h:640
btVector3::length2
btScalar length2() const
Return the length of the vector squared.
Definition: btVector3.h:251
btVector3::getY
const btScalar & getY() const
Return the y value.
Definition: btVector3.h:563
btVector3::normalize
btVector3 & normalize()
Normalize this vector x^2 + y^2 + z^2 = 1.
Definition: btVector3.h:303
btVector3::getX
const btScalar & getX() const
Return the x value.
Definition: btVector3.h:561
btConvexInternalShapeData
do not change those serialization structures, it requires an updated sBulletDNAstr/sBulletDNAstr64
Definition: btConvexInternalShape.h:136
btCylinderShapeData
do not change those serialization structures, it requires an updated sBulletDNAstr/sBulletDNAstr64
Definition: btCylinderShape.h:175
btCylinderShapeData::m_convexInternalShapeData
btConvexInternalShapeData m_convexInternalShapeData
Definition: btCylinderShape.h:176
btCylinderShapeData::m_padding
char m_padding[4]
Definition: btCylinderShape.h:180
btCylinderShapeData::m_upAxis
int m_upAxis
Definition: btCylinderShape.h:178