dali-physics/third-party/bullet3/src/BulletDynamics/Featherstone/btMultiBodyConstraintSolver.h

   1 /*
   2 Bullet Continuous Collision Detection and Physics Library
   3 Copyright (c) 2013 Erwin Coumans  http://bulletphysics.org
   4
   5 This software is provided 'as-is', without any express or implied warranty.
   6 In no event will the authors be held liable for any damages arising from the use of this software.
   7 Permission is granted to anyone to use this software for any purpose,
   8 including commercial applications, and to alter it and redistribute it freely,
   9 subject to the following restrictions:
  10
  11 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.
  12 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
  13 3. This notice may not be removed or altered from any source distribution.
  14 */
  15
  16 #ifndef BT_MULTIBODY_CONSTRAINT_SOLVER_H
  17 #define BT_MULTIBODY_CONSTRAINT_SOLVER_H
  18
  19 #include "BulletDynamics/ConstraintSolver/btSequentialImpulseConstraintSolver.h"
  20 #include "btMultiBodySolverConstraint.h"
  21
  22 #define DIRECTLY_UPDATE_VELOCITY_DURING_SOLVER_ITERATIONS
  23
  24 class btMultiBody;
  25
  26 #include "btMultiBodyConstraint.h"
  27
  28 ATTRIBUTE_ALIGNED16(class)
  29 btMultiBodyConstraintSolver : public btSequentialImpulseConstraintSolver
  30 {
  31 protected:
  32         btMultiBodyConstraintArray m_multiBodyNonContactConstraints;
  33
  34         btMultiBodyConstraintArray m_multiBodyNormalContactConstraints;
  35         btMultiBodyConstraintArray m_multiBodyFrictionContactConstraints;
  36         btMultiBodyConstraintArray m_multiBodyTorsionalFrictionContactConstraints;
  37         btMultiBodyConstraintArray m_multiBodySpinningFrictionContactConstraints;
  38
  39         btMultiBodyJacobianData m_data;
  40
  41         //temp storage for multi body constraints for a specific island/group called by 'solveGroup'
  42         btMultiBodyConstraint** m_tmpMultiBodyConstraints;
  43         int m_tmpNumMultiBodyConstraints;
  44
  45         btScalar resolveSingleConstraintRowGeneric(const btMultiBodySolverConstraint& c);
  46
  47         //solve 2 friction directions and clamp against the implicit friction cone
  48         btScalar resolveConeFrictionConstraintRows(const btMultiBodySolverConstraint& cA1, const btMultiBodySolverConstraint& cB);
  49
  50         void convertContacts(btPersistentManifold * *manifoldPtr, int numManifolds, const btContactSolverInfo& infoGlobal);
  51
  52         btMultiBodySolverConstraint& addMultiBodyFrictionConstraint(const btVector3& normalAxis, const btScalar& appliedImpulse, btPersistentManifold* manifold, int frictionIndex, btManifoldPoint& cp, btCollisionObject* colObj0, btCollisionObject* colObj1, btScalar relaxation, const btContactSolverInfo& infoGlobal, btScalar desiredVelocity = 0, btScalar cfmSlip = 0);
  53
  54         btMultiBodySolverConstraint& addMultiBodyTorsionalFrictionConstraint(const btVector3& normalAxis, btPersistentManifold* manifold, int frictionIndex, btManifoldPoint& cp,
  55                                                                                                                                                  btScalar combinedTorsionalFriction,
  56                                                                                                                                                  btCollisionObject* colObj0, btCollisionObject* colObj1, btScalar relaxation, const btContactSolverInfo& infoGlobal, btScalar desiredVelocity = 0, btScalar cfmSlip = 0);
  57
  58         btMultiBodySolverConstraint& addMultiBodySpinningFrictionConstraint(const btVector3& normalAxis, btPersistentManifold* manifold, int frictionIndex, btManifoldPoint& cp,
  59                 btScalar combinedTorsionalFriction,
  60                 btCollisionObject* colObj0, btCollisionObject* colObj1, btScalar relaxation, const btContactSolverInfo& infoGlobal, btScalar desiredVelocity = 0, btScalar cfmSlip = 0);
  61
  62         void setupMultiBodyJointLimitConstraint(btMultiBodySolverConstraint & constraintRow,
  63                                                                                         btScalar * jacA, btScalar * jacB,
  64                                                                                         btScalar penetration, btScalar combinedFrictionCoeff, btScalar combinedRestitutionCoeff,
  65                                                                                         const btContactSolverInfo& infoGlobal);
  66
  67         void setupMultiBodyContactConstraint(btMultiBodySolverConstraint & solverConstraint,
  68                                                                                  const btVector3& contactNormal,
  69                      const btScalar& appliedImpulse,
  70                                                                                  btManifoldPoint& cp,
  71                      const btContactSolverInfo& infoGlobal,
  72                                                                                  btScalar& relaxation,
  73                                                                                  bool isFriction, btScalar desiredVelocity = 0, btScalar cfmSlip = 0);
  74
  75         //either rolling or spinning friction
  76         void setupMultiBodyTorsionalFrictionConstraint(btMultiBodySolverConstraint & solverConstraint,
  77                                                                                                    const btVector3& contactNormal,
  78                                                                                                    btManifoldPoint& cp,
  79                                                                                                    btScalar combinedTorsionalFriction,
  80                                                                                                    const btContactSolverInfo& infoGlobal,
  81                                                                                                    btScalar& relaxation,
  82                                                                                                    bool isFriction, btScalar desiredVelocity = 0, btScalar cfmSlip = 0);
  83
  84         void convertMultiBodyContact(btPersistentManifold * manifold, const btContactSolverInfo& infoGlobal);
  85         virtual btScalar solveGroupCacheFriendlySetup(btCollisionObject * *bodies, int numBodies, btPersistentManifold** manifoldPtr, int numManifolds, btTypedConstraint** constraints, int numConstraints, const btContactSolverInfo& infoGlobal, btIDebugDraw* debugDrawer);
  86         //      virtual btScalar solveGroupCacheFriendlyIterations(btCollisionObject** bodies,int numBodies,btPersistentManifold** manifoldPtr, int numManifolds,btTypedConstraint** constraints,int numConstraints,const btContactSolverInfo& infoGlobal,btIDebugDraw* debugDrawer);
  87         virtual btScalar solveSingleIteration(int iteration, btCollisionObject** bodies, int numBodies, btPersistentManifold** manifoldPtr, int numManifolds, btTypedConstraint** constraints, int numConstraints, const btContactSolverInfo& infoGlobal, btIDebugDraw* debugDrawer);
  88         void applyDeltaVee(btScalar * deltaV, btScalar impulse, int velocityIndex, int ndof);
  89         void writeBackSolverBodyToMultiBody(btMultiBodySolverConstraint & constraint, btScalar deltaTime);
  90
  91 public:
  92         BT_DECLARE_ALIGNED_ALLOCATOR();
  93
  94         ///this method should not be called, it was just used during porting/integration of Featherstone btMultiBody, providing backwards compatibility but no support for btMultiBodyConstraint (only contact constraints)
  95         virtual btScalar solveGroup(btCollisionObject * *bodies, int numBodies, btPersistentManifold** manifold, int numManifolds, btTypedConstraint** constraints, int numConstraints, const btContactSolverInfo& info, btIDebugDraw* debugDrawer, btDispatcher* dispatcher);
  96         virtual btScalar solveGroupCacheFriendlyFinish(btCollisionObject * *bodies, int numBodies, const btContactSolverInfo& infoGlobal);
  97
  98         virtual void solveMultiBodyGroup(btCollisionObject * *bodies, int numBodies, btPersistentManifold** manifold, int numManifolds, btTypedConstraint** constraints, int numConstraints, btMultiBodyConstraint** multiBodyConstraints, int numMultiBodyConstraints, const btContactSolverInfo& info, btIDebugDraw* debugDrawer, btDispatcher* dispatcher);
  99 };
 100
 101 #endif  //BT_MULTIBODY_CONSTRAINT_SOLVER_H