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

其他游戏

开发平台:

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_EASE_PENETRATION_ACTION_H
  9. #define HK_EASE_PENETRATION_ACTION_H
  10. #include <Physics/Dynamics/Action/hkpUnaryAction.h>
  11. #include <Common/Base/hkBase.h>
  12. /// You can use this action to reduce CPU hits that occur when a new body is added to a hkpWorld in a penetrating state.
  13. ///
  14. /// When you add a simple shape, like a box, and place it in a way that it deeply intersects with around 8 triangles of a landscape
  15. /// mesh -- then you can expect high numbers of unjustified TOI events being handled. In a simple test case we performed, there were
  16. /// around 10 TOIs for a moving-quality body, and around 80!!! for a critical-quality body.
  17. ///
  18. /// This utility controls the m_allowedPenetrationDepth property of a rigid body over a short time of, e.g. a few seconds, to 
  19. /// avoid those unneeded TOIs and to allow the bodies to recover from penetration with normal collision response.
  20. /// After m_timePassed reaches m_duration, the m_alloedPenetrationDepth of the hkpRigidBody is set back to its original value.
  21. ///
  22. /// Additionally this utility can also reduce the strength at which the solver corrects inter-body penetrations. This is done by 
  23. /// iterating over all contact points, and reducing the penetration distance, that is later fed into the constraint solver.
  24. /// As the result, less jitter may occur when bodies recover from penetration.
  25. class hkpEasePenetrationAction : public hkpUnaryAction
  26. {
  27. public:
  28. // This allows you to specify duration of the action. Other values can be set directly after the action is constructed.
  29. hkpEasePenetrationAction(hkpEntity* entity, hkReal duration);
  30. // hkpAction implementation.
  31. virtual void applyAction( const hkStepInfo& stepInfo );
  32. virtual hkpAction* clone( const hkArray<hkpEntity*>& newEntities, const hkArray<hkpPhantom*>& newPhantoms ) const ;
  33. public:
  34. /// Duration of this action. After the time passes the action removes itself from the hkpWorld.
  35. hkReal m_duration;
  36. /// Initial multiplier for the m_entity's m_allowedPenetrationDepth. It's reduced linearly with time to reach 1.0f at the end of m_duration.
  37. hkReal m_initialAllowedPenetrationDepthMultiplier;
  38. /// Initial added value for the m_entity's m_allowedPenetrationDepth. It's reduced linearly with time to reach 0.0f at the end of m_duration.
  39. hkReal m_initialAdditionalAllowedPenetrationDepth;
  40. /// Shall the action soften the solver response too, by reducing penetration distances for contact points.
  41. bool m_reducePenetrationDistance;
  42. /// Initial distance multiplier applied for all penetrating contact points. It's reduced linearly with time to reach 1.0f at the end of m_duration.
  43. /// Don't use small values, as this may cause bodies to fall through the ground. It's set to 0.2 by default.
  44. hkReal m_initialContactDepthMultiplier;
  45. private:
  46. /// Time passed since the action was added to the world.
  47. hkReal m_timePassed;
  48. /// Original allowed penetration depth of the m_entity.
  49. hkReal m_originalAllowedPenetrationDepth;
  50. };
  51. #endif // HK_EASE_PENETRATION_ACTION_H
  52. /*
  53. * Havok SDK - NO SOURCE PC DOWNLOAD, BUILD(#20090216)
  54. * Confidential Information of Havok.  (C) Copyright 1999-2009
  55. * Telekinesys Research Limited t/a Havok. All Rights Reserved. The Havok
  56. * Logo, and the Havok buzzsaw logo are trademarks of Havok.  Title, ownership
  57. * rights, and intellectual property rights in the Havok software remain in
  58. * Havok and/or its suppliers.
  59. * Use of this software for evaluation purposes is subject to and indicates
  60. * acceptance of the End User licence Agreement for this product. A copy of
  61. * the license is included with this software and is also available at www.havok.com/tryhavok.
  62. */