[1963] | 1 | /* |
---|
| 2 | Copyright (c) 2005 Gino van den Bergen / Erwin Coumans http://continuousphysics.com |
---|
| 3 | |
---|
| 4 | Permission is hereby granted, free of charge, to any person or organization |
---|
| 5 | obtaining a copy of the software and accompanying documentation covered by |
---|
| 6 | this license (the "Software") to use, reproduce, display, distribute, |
---|
| 7 | execute, and transmit the Software, and to prepare derivative works of the |
---|
| 8 | Software, and to permit third-parties to whom the Software is furnished to |
---|
| 9 | do so, all subject to the following: |
---|
| 10 | |
---|
| 11 | The copyright notices in the Software and this entire statement, including |
---|
| 12 | the above license grant, this restriction and the following disclaimer, |
---|
| 13 | must be included in all copies of the Software, in whole or in part, and |
---|
| 14 | all derivative works of the Software, unless such copies or derivative |
---|
| 15 | works are solely in the form of machine-executable object code generated by |
---|
| 16 | a source language processor. |
---|
| 17 | |
---|
| 18 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
---|
| 19 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
---|
| 20 | FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT |
---|
| 21 | SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE |
---|
| 22 | FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, |
---|
| 23 | ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
---|
| 24 | DEALINGS IN THE SOFTWARE. |
---|
| 25 | */ |
---|
| 26 | |
---|
| 27 | |
---|
| 28 | #ifndef IDEBUG_DRAW__H |
---|
| 29 | #define IDEBUG_DRAW__H |
---|
| 30 | |
---|
| 31 | #include "btVector3.h" |
---|
[2882] | 32 | #include "btTransform.h" |
---|
[1963] | 33 | |
---|
| 34 | |
---|
| 35 | ///The btIDebugDraw interface class allows hooking up a debug renderer to visually debug simulations. |
---|
| 36 | ///Typical use case: create a debug drawer object, and assign it to a btCollisionWorld or btDynamicsWorld using setDebugDrawer and call debugDrawWorld. |
---|
| 37 | ///A class that implements the btIDebugDraw interface has to implement the drawLine method at a minimum. |
---|
| 38 | class btIDebugDraw |
---|
| 39 | { |
---|
| 40 | public: |
---|
| 41 | |
---|
| 42 | enum DebugDrawModes |
---|
| 43 | { |
---|
| 44 | DBG_NoDebug=0, |
---|
| 45 | DBG_DrawWireframe = 1, |
---|
| 46 | DBG_DrawAabb=2, |
---|
| 47 | DBG_DrawFeaturesText=4, |
---|
| 48 | DBG_DrawContactPoints=8, |
---|
| 49 | DBG_NoDeactivation=16, |
---|
| 50 | DBG_NoHelpText = 32, |
---|
| 51 | DBG_DrawText=64, |
---|
| 52 | DBG_ProfileTimings = 128, |
---|
| 53 | DBG_EnableSatComparison = 256, |
---|
| 54 | DBG_DisableBulletLCP = 512, |
---|
| 55 | DBG_EnableCCD = 1024, |
---|
[2882] | 56 | DBG_DrawConstraints = (1 << 11), |
---|
| 57 | DBG_DrawConstraintLimits = (1 << 12), |
---|
[1963] | 58 | DBG_MAX_DEBUG_DRAW_MODE |
---|
| 59 | }; |
---|
| 60 | |
---|
| 61 | virtual ~btIDebugDraw() {}; |
---|
| 62 | |
---|
[2882] | 63 | virtual void drawLine(const btVector3& from,const btVector3& to, const btVector3& fromColor, const btVector3& toColor) |
---|
| 64 | { |
---|
| 65 | drawLine (from, to, fromColor); |
---|
| 66 | } |
---|
| 67 | |
---|
| 68 | virtual void drawBox (const btVector3& boxMin, const btVector3& boxMax, const btVector3& color, btScalar alpha) |
---|
| 69 | { |
---|
| 70 | } |
---|
| 71 | |
---|
| 72 | virtual void drawSphere (const btVector3& p, btScalar radius, const btVector3& color) |
---|
| 73 | { |
---|
| 74 | } |
---|
| 75 | |
---|
[1963] | 76 | virtual void drawLine(const btVector3& from,const btVector3& to,const btVector3& color)=0; |
---|
| 77 | |
---|
| 78 | virtual void drawTriangle(const btVector3& v0,const btVector3& v1,const btVector3& v2,const btVector3& /*n0*/,const btVector3& /*n1*/,const btVector3& /*n2*/,const btVector3& color, btScalar alpha) |
---|
| 79 | { |
---|
| 80 | drawTriangle(v0,v1,v2,color,alpha); |
---|
| 81 | } |
---|
| 82 | virtual void drawTriangle(const btVector3& v0,const btVector3& v1,const btVector3& v2,const btVector3& color, btScalar /*alpha*/) |
---|
| 83 | { |
---|
| 84 | drawLine(v0,v1,color); |
---|
| 85 | drawLine(v1,v2,color); |
---|
| 86 | drawLine(v2,v0,color); |
---|
| 87 | } |
---|
| 88 | |
---|
| 89 | virtual void drawContactPoint(const btVector3& PointOnB,const btVector3& normalOnB,btScalar distance,int lifeTime,const btVector3& color)=0; |
---|
| 90 | |
---|
| 91 | virtual void reportErrorWarning(const char* warningString) = 0; |
---|
| 92 | |
---|
| 93 | virtual void draw3dText(const btVector3& location,const char* textString) = 0; |
---|
| 94 | |
---|
| 95 | virtual void setDebugMode(int debugMode) =0; |
---|
| 96 | |
---|
| 97 | virtual int getDebugMode() const = 0; |
---|
| 98 | |
---|
| 99 | inline void drawAabb(const btVector3& from,const btVector3& to,const btVector3& color) |
---|
| 100 | { |
---|
| 101 | |
---|
| 102 | btVector3 halfExtents = (to-from)* 0.5f; |
---|
| 103 | btVector3 center = (to+from) *0.5f; |
---|
| 104 | int i,j; |
---|
| 105 | |
---|
| 106 | btVector3 edgecoord(1.f,1.f,1.f),pa,pb; |
---|
| 107 | for (i=0;i<4;i++) |
---|
| 108 | { |
---|
| 109 | for (j=0;j<3;j++) |
---|
| 110 | { |
---|
| 111 | pa = btVector3(edgecoord[0]*halfExtents[0], edgecoord[1]*halfExtents[1], |
---|
| 112 | edgecoord[2]*halfExtents[2]); |
---|
| 113 | pa+=center; |
---|
| 114 | |
---|
| 115 | int othercoord = j%3; |
---|
| 116 | edgecoord[othercoord]*=-1.f; |
---|
| 117 | pb = btVector3(edgecoord[0]*halfExtents[0], edgecoord[1]*halfExtents[1], |
---|
| 118 | edgecoord[2]*halfExtents[2]); |
---|
| 119 | pb+=center; |
---|
| 120 | |
---|
| 121 | drawLine(pa,pb,color); |
---|
| 122 | } |
---|
| 123 | edgecoord = btVector3(-1.f,-1.f,-1.f); |
---|
| 124 | if (i<3) |
---|
| 125 | edgecoord[i]*=-1.f; |
---|
| 126 | } |
---|
| 127 | } |
---|
[2882] | 128 | void drawTransform(const btTransform& transform, btScalar orthoLen) |
---|
| 129 | { |
---|
| 130 | btVector3 start = transform.getOrigin(); |
---|
| 131 | drawLine(start, start+transform.getBasis() * btVector3(orthoLen, 0, 0), btVector3(0.7f,0,0)); |
---|
| 132 | drawLine(start, start+transform.getBasis() * btVector3(0, orthoLen, 0), btVector3(0,0.7f,0)); |
---|
| 133 | drawLine(start, start+transform.getBasis() * btVector3(0, 0, orthoLen), btVector3(0,0,0.7f)); |
---|
| 134 | } |
---|
| 135 | |
---|
| 136 | void drawArc(const btVector3& center, const btVector3& normal, const btVector3& axis, btScalar radiusA, btScalar radiusB, btScalar minAngle, btScalar maxAngle, |
---|
| 137 | const btVector3& color, bool drawSect, btScalar stepDegrees = btScalar(10.f)) |
---|
| 138 | { |
---|
| 139 | const btVector3& vx = axis; |
---|
| 140 | btVector3 vy = normal.cross(axis); |
---|
| 141 | btScalar step = stepDegrees * SIMD_RADS_PER_DEG; |
---|
| 142 | int nSteps = (int)((maxAngle - minAngle) / step); |
---|
| 143 | if(!nSteps) nSteps = 1; |
---|
| 144 | btVector3 prev = center + radiusA * vx * btCos(minAngle) + radiusB * vy * btSin(minAngle); |
---|
| 145 | if(drawSect) |
---|
| 146 | { |
---|
| 147 | drawLine(center, prev, color); |
---|
| 148 | } |
---|
| 149 | for(int i = 1; i <= nSteps; i++) |
---|
| 150 | { |
---|
| 151 | btScalar angle = minAngle + (maxAngle - minAngle) * btScalar(i) / btScalar(nSteps); |
---|
| 152 | btVector3 next = center + radiusA * vx * btCos(angle) + radiusB * vy * btSin(angle); |
---|
| 153 | drawLine(prev, next, color); |
---|
| 154 | prev = next; |
---|
| 155 | } |
---|
| 156 | if(drawSect) |
---|
| 157 | { |
---|
| 158 | drawLine(center, prev, color); |
---|
| 159 | } |
---|
| 160 | } |
---|
| 161 | void drawSpherePatch(const btVector3& center, const btVector3& up, const btVector3& axis, btScalar radius, |
---|
| 162 | btScalar minTh, btScalar maxTh, btScalar minPs, btScalar maxPs, const btVector3& color, btScalar stepDegrees = btScalar(10.f)) |
---|
| 163 | { |
---|
| 164 | btVector3 vA[74]; |
---|
| 165 | btVector3 vB[74]; |
---|
| 166 | btVector3 *pvA = vA, *pvB = vB, *pT; |
---|
| 167 | btVector3 npole = center + up * radius; |
---|
| 168 | btVector3 spole = center - up * radius; |
---|
| 169 | btVector3 arcStart; |
---|
| 170 | btScalar step = stepDegrees * SIMD_RADS_PER_DEG; |
---|
| 171 | const btVector3& kv = up; |
---|
| 172 | const btVector3& iv = axis; |
---|
| 173 | btVector3 jv = kv.cross(iv); |
---|
| 174 | bool drawN = false; |
---|
| 175 | bool drawS = false; |
---|
| 176 | if(minTh <= -SIMD_HALF_PI) |
---|
| 177 | { |
---|
| 178 | minTh = -SIMD_HALF_PI + step; |
---|
| 179 | drawN = true; |
---|
| 180 | } |
---|
| 181 | if(maxTh >= SIMD_HALF_PI) |
---|
| 182 | { |
---|
| 183 | maxTh = SIMD_HALF_PI - step; |
---|
| 184 | drawS = true; |
---|
| 185 | } |
---|
| 186 | if(minTh > maxTh) |
---|
| 187 | { |
---|
| 188 | minTh = -SIMD_HALF_PI + step; |
---|
| 189 | maxTh = SIMD_HALF_PI - step; |
---|
| 190 | drawN = drawS = true; |
---|
| 191 | } |
---|
| 192 | int n_hor = (int)((maxTh - minTh) / step) + 1; |
---|
| 193 | if(n_hor < 2) n_hor = 2; |
---|
| 194 | btScalar step_h = (maxTh - minTh) / btScalar(n_hor - 1); |
---|
| 195 | bool isClosed = false; |
---|
| 196 | if(minPs > maxPs) |
---|
| 197 | { |
---|
| 198 | minPs = -SIMD_PI + step; |
---|
| 199 | maxPs = SIMD_PI; |
---|
| 200 | isClosed = true; |
---|
| 201 | } |
---|
| 202 | else if((maxPs - minPs) >= SIMD_PI * btScalar(2.f)) |
---|
| 203 | { |
---|
| 204 | isClosed = true; |
---|
| 205 | } |
---|
| 206 | else |
---|
| 207 | { |
---|
| 208 | isClosed = false; |
---|
| 209 | } |
---|
| 210 | int n_vert = (int)((maxPs - minPs) / step) + 1; |
---|
| 211 | if(n_vert < 2) n_vert = 2; |
---|
| 212 | btScalar step_v = (maxPs - minPs) / btScalar(n_vert - 1); |
---|
| 213 | for(int i = 0; i < n_hor; i++) |
---|
| 214 | { |
---|
| 215 | btScalar th = minTh + btScalar(i) * step_h; |
---|
| 216 | btScalar sth = radius * btSin(th); |
---|
| 217 | btScalar cth = radius * btCos(th); |
---|
| 218 | for(int j = 0; j < n_vert; j++) |
---|
| 219 | { |
---|
| 220 | btScalar psi = minPs + btScalar(j) * step_v; |
---|
| 221 | btScalar sps = btSin(psi); |
---|
| 222 | btScalar cps = btCos(psi); |
---|
| 223 | pvB[j] = center + cth * cps * iv + cth * sps * jv + sth * kv; |
---|
| 224 | if(i) |
---|
| 225 | { |
---|
| 226 | drawLine(pvA[j], pvB[j], color); |
---|
| 227 | } |
---|
| 228 | else if(drawS) |
---|
| 229 | { |
---|
| 230 | drawLine(spole, pvB[j], color); |
---|
| 231 | } |
---|
| 232 | if(j) |
---|
| 233 | { |
---|
| 234 | drawLine(pvB[j-1], pvB[j], color); |
---|
| 235 | } |
---|
| 236 | else |
---|
| 237 | { |
---|
| 238 | arcStart = pvB[j]; |
---|
| 239 | } |
---|
| 240 | if((i == (n_hor - 1)) && drawN) |
---|
| 241 | { |
---|
| 242 | drawLine(npole, pvB[j], color); |
---|
| 243 | } |
---|
| 244 | if(isClosed) |
---|
| 245 | { |
---|
| 246 | if(j == (n_vert-1)) |
---|
| 247 | { |
---|
| 248 | drawLine(arcStart, pvB[j], color); |
---|
| 249 | } |
---|
| 250 | } |
---|
| 251 | else |
---|
| 252 | { |
---|
| 253 | if(((!i) || (i == (n_hor-1))) && ((!j) || (j == (n_vert-1)))) |
---|
| 254 | { |
---|
| 255 | drawLine(center, pvB[j], color); |
---|
| 256 | } |
---|
| 257 | } |
---|
| 258 | } |
---|
| 259 | pT = pvA; pvA = pvB; pvB = pT; |
---|
| 260 | } |
---|
| 261 | } |
---|
| 262 | |
---|
| 263 | void drawBox(const btVector3& bbMin, const btVector3& bbMax, const btVector3& color) |
---|
| 264 | { |
---|
| 265 | drawLine(btVector3(bbMin[0], bbMin[1], bbMin[2]), btVector3(bbMax[0], bbMin[1], bbMin[2]), color); |
---|
| 266 | drawLine(btVector3(bbMax[0], bbMin[1], bbMin[2]), btVector3(bbMax[0], bbMax[1], bbMin[2]), color); |
---|
| 267 | drawLine(btVector3(bbMax[0], bbMax[1], bbMin[2]), btVector3(bbMin[0], bbMax[1], bbMin[2]), color); |
---|
| 268 | drawLine(btVector3(bbMin[0], bbMax[1], bbMin[2]), btVector3(bbMin[0], bbMin[1], bbMin[2]), color); |
---|
| 269 | drawLine(btVector3(bbMin[0], bbMin[1], bbMin[2]), btVector3(bbMin[0], bbMin[1], bbMax[2]), color); |
---|
| 270 | drawLine(btVector3(bbMax[0], bbMin[1], bbMin[2]), btVector3(bbMax[0], bbMin[1], bbMax[2]), color); |
---|
| 271 | drawLine(btVector3(bbMax[0], bbMax[1], bbMin[2]), btVector3(bbMax[0], bbMax[1], bbMax[2]), color); |
---|
| 272 | drawLine(btVector3(bbMin[0], bbMax[1], bbMin[2]), btVector3(bbMin[0], bbMax[1], bbMax[2]), color); |
---|
| 273 | drawLine(btVector3(bbMin[0], bbMin[1], bbMax[2]), btVector3(bbMax[0], bbMin[1], bbMax[2]), color); |
---|
| 274 | drawLine(btVector3(bbMax[0], bbMin[1], bbMax[2]), btVector3(bbMax[0], bbMax[1], bbMax[2]), color); |
---|
| 275 | drawLine(btVector3(bbMax[0], bbMax[1], bbMax[2]), btVector3(bbMin[0], bbMax[1], bbMax[2]), color); |
---|
| 276 | drawLine(btVector3(bbMin[0], bbMax[1], bbMax[2]), btVector3(bbMin[0], bbMin[1], bbMax[2]), color); |
---|
| 277 | } |
---|
| 278 | void drawBox(const btVector3& bbMin, const btVector3& bbMax, const btTransform& trans, const btVector3& color) |
---|
| 279 | { |
---|
| 280 | drawLine(trans * btVector3(bbMin[0], bbMin[1], bbMin[2]), trans * btVector3(bbMax[0], bbMin[1], bbMin[2]), color); |
---|
| 281 | drawLine(trans * btVector3(bbMax[0], bbMin[1], bbMin[2]), trans * btVector3(bbMax[0], bbMax[1], bbMin[2]), color); |
---|
| 282 | drawLine(trans * btVector3(bbMax[0], bbMax[1], bbMin[2]), trans * btVector3(bbMin[0], bbMax[1], bbMin[2]), color); |
---|
| 283 | drawLine(trans * btVector3(bbMin[0], bbMax[1], bbMin[2]), trans * btVector3(bbMin[0], bbMin[1], bbMin[2]), color); |
---|
| 284 | drawLine(trans * btVector3(bbMin[0], bbMin[1], bbMin[2]), trans * btVector3(bbMin[0], bbMin[1], bbMax[2]), color); |
---|
| 285 | drawLine(trans * btVector3(bbMax[0], bbMin[1], bbMin[2]), trans * btVector3(bbMax[0], bbMin[1], bbMax[2]), color); |
---|
| 286 | drawLine(trans * btVector3(bbMax[0], bbMax[1], bbMin[2]), trans * btVector3(bbMax[0], bbMax[1], bbMax[2]), color); |
---|
| 287 | drawLine(trans * btVector3(bbMin[0], bbMax[1], bbMin[2]), trans * btVector3(bbMin[0], bbMax[1], bbMax[2]), color); |
---|
| 288 | drawLine(trans * btVector3(bbMin[0], bbMin[1], bbMax[2]), trans * btVector3(bbMax[0], bbMin[1], bbMax[2]), color); |
---|
| 289 | drawLine(trans * btVector3(bbMax[0], bbMin[1], bbMax[2]), trans * btVector3(bbMax[0], bbMax[1], bbMax[2]), color); |
---|
| 290 | drawLine(trans * btVector3(bbMax[0], bbMax[1], bbMax[2]), trans * btVector3(bbMin[0], bbMax[1], bbMax[2]), color); |
---|
| 291 | drawLine(trans * btVector3(bbMin[0], bbMax[1], bbMax[2]), trans * btVector3(bbMin[0], bbMin[1], bbMax[2]), color); |
---|
| 292 | } |
---|
[1963] | 293 | }; |
---|
| 294 | |
---|
| 295 | |
---|
| 296 | #endif //IDEBUG_DRAW__H |
---|
| 297 | |
---|