hkpResponseModifier.h
上传用户:yisoukefu
上传日期:2020-08-09
资源大小:39506k
文件大小:6k
源码类别:

其他游戏

开发平台:

Visual C++

  1. /* 
  2.  * 
  3.  * Confidential Information of Telekinesys Research Limited (t/a Havok). Not for disclosure or distribution without Havok's
  4.  * prior written consent. This software contains code, techniques and know-how which is confidential and proprietary to Havok.
  5.  * Level 2 and Level 3 source code contains trade secrets of Havok. Havok Software (C) Copyright 1999-2009 Telekinesys Research Limited t/a Havok. All Rights Reserved. Use of this software is subject to the terms of an end user license agreement.
  6.  * 
  7.  */
  8. #ifndef HK_DYNAMICS2_RESPONSE_MODIFIER_H
  9. #define HK_DYNAMICS2_RESPONSE_MODIFIER_H
  10. class hkpDynamicsContactMgr;
  11. class hkpRigidBody;
  12. /// This class contains a number of functions to allow altering the behavior of collision response
  13. /// This class has a number of restrictions:
  14. ///    - Each modifier can only exist once. E.g. setting the mass scaling overrides previous mass scaling modifiers
  15. ///    - These modifiers change the constraint hierarchy, so you need access to the hkpConstraintOwner
  16. ///      You can get an hkpConstraintOwner in two ways:
  17. ///             -  by getting write access to the world (hkpWorld::lock()) and simply using the non fixed island of one of the entities
  18. /// (a hkpSimulationIsland inherits from hkpConstraintOwner)
  19. /// -  if called from a collision callback simply use event.m_output.m_constraintOwner or event.m_constraintOwner
  20. /// - Modifiers will not be serialized
  21. class hkpResponseModifier
  22. {
  23. public:
  24. /// Scales the inverse mass of both bodies by the relevant scaling factors.
  25. /// param factorA the modification of the inverse mass of body A. The first three components modify the body's
  26. /// inertia in its principal axes and the fourth modifies its mass.
  27. /// param factorB the modification of the inverse mass of body B.
  28. /// Note: Passing in the zero vector as factor makes the entity "fixed" for the purpose of resolving this contact constraint.
  29. /// The constraint owner typically is the island of the involved objects. However if you call this function from a collision
  30. /// callback, you need to use event.m_collisionData.m_constraintOwner
  31. static void HK_CALL setInvMassScalingForContact( hkpDynamicsContactMgr* manager, hkpRigidBody* bodyA, hkpRigidBody* bodyB, hkpConstraintOwner& constraintOwner, const hkVector4& factorA, const hkVector4& factorB );
  32. /// Scales the inverse mass of one body by the relevant scaling factor, leaving the scaling factor for the other body untouched.
  33. /// param factor the modification of the inverse mass. The first three components modify the body's inertia in its
  34. /// principal axes and the fourth modifies its mass.
  35. /// Note: Passing in the zero vector as factor makes the entity "fixed" for the purpose of resolving this contact constraint.
  36. /// The constraint owner typically is the island of the involved objects. However if you call this function from a collision
  37. /// callback, you need to use event.m_collisionData.m_constraintOwner
  38. static void HK_CALL setInvMassScalingForContact( hkpDynamicsContactMgr* manager, hkpRigidBody* body, hkpConstraintOwner& constraintOwner, const hkVector4& factor );
  39. /// Moves the center of mass of each object by a distance.
  40. ///
  41. /// The constraint owner typically is the island of the involved objects. However if you call this function from a collision
  42. /// callback, you need to use event.m_collisionData.m_constraintOwner
  43. static void HK_CALL setCenterOfMassDisplacementForContact( hkpDynamicsContactMgr* manager, hkpRigidBody* bodyA, hkpRigidBody* bodyB, hkpConstraintOwner& constraintOwner, const hkVector4& displacementA, const hkVector4& displacementB );
  44. /// Scales and clips the force applied by a contact. 
  45. ///
  46. /// usedImpulseFraction scales the forces, e.g. using values less than 0.2f yields noticeably softer contact response
  47. /// and allows object to penetrate. They do get a softer/springy behavior.
  48. /// The parameter maxAcceleration clips the maximum forced used. This parameter does not introduce springyness.
  49. /// Try different combinations of the parameters to get the desired effect.
  50. /// 
  51. /// The constraint owner typically is the island of the involved objects. However if you call this function from a collision
  52. /// callback, you need to use event.m_collisionOutput.m_constraintOwner
  53. static void HK_CALL setImpulseScalingForContact( hkpDynamicsContactMgr* manager, hkpRigidBody* bodyA, hkpRigidBody* bodyB, hkpConstraintOwner& constraintOwner, hkReal usedImpulseFraction, hkReal maxAcceleration );
  54. /// sets the surfaceVelocity
  55. static void HK_CALL setSurfaceVelocity( hkpDynamicsContactMgr* manager, hkpRigidBody* body, hkpConstraintOwner& constraintOwner, const hkVector4& velWorld );
  56. /// removes the surfaceVelocity
  57. /// NOTE: ONLY USE THIS FUNCTION AFTER CALLING setSurfaceVelocity
  58. static void HK_CALL clearSurfaceVelocity( hkpDynamicsContactMgr* manager, hkpConstraintOwner& constraintOwner, hkpRigidBody* body );
  59. /// sets the surface to have low viscosity. Effectively disables static friction.
  60. static void HK_CALL setLowSurfaceViscosity( hkpDynamicsContactMgr* manager, hkpConstraintOwner& constraintOwner );
  61. /// Marks the constraint to not go into the solver. 
  62. /// A disabled constraint is still in the world, and still ensures the linked bodies are in the same hkpSimulationIsland.
  63. static void HK_CALL disableConstraint(hkpConstraintInstance* instance, hkpConstraintOwner& constraintOwner);
  64. /// Marks the constraint to go into the solver.
  65. static void HK_CALL enableConstraint(hkpConstraintInstance* instance, hkpConstraintOwner& constraintOwner);
  66. };
  67. #endif // HK_DYNAMICS2_RESPONSE_MODIFIER_H
  68. /*
  69. * Havok SDK - NO SOURCE PC DOWNLOAD, BUILD(#20090216)
  70. * Confidential Information of Havok.  (C) Copyright 1999-2009
  71. * Telekinesys Research Limited t/a Havok. All Rights Reserved. The Havok
  72. * Logo, and the Havok buzzsaw logo are trademarks of Havok.  Title, ownership
  73. * rights, and intellectual property rights in the Havok software remain in
  74. * Havok and/or its suppliers.
  75. * Use of this software for evaluation purposes is subject to and indicates
  76. * acceptance of the End User licence Agreement for this product. A copy of
  77. * the license is included with this software and is also available at www.havok.com/tryhavok.
  78. */