b2DistanceJoint.h
上传用户:gb3593
上传日期:2022-01-07
资源大小:3028k
文件大小:4k
源码类别:

游戏引擎

开发平台:

Visual C++

  1. /*
  2. * Copyright (c) 2006-2007 Erin Catto http://www.gphysics.com
  3. *
  4. * This software is provided 'as-is', without any express or implied
  5. * warranty.  In no event will the authors be held liable for any damages
  6. * 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
  9. * freely, subject to the following restrictions:
  10. * 1. The origin of this software must not be misrepresented; you must not
  11. * claim that you wrote the original software. If you use this software
  12. * in a product, an acknowledgment in the product documentation would be
  13. * appreciated but is not required.
  14. * 2. Altered source versions must be plainly marked as such, and must not be
  15. * misrepresented as being the original software.
  16. * 3. This notice may not be removed or altered from any source distribution.
  17. */
  18. #ifndef B2_DISTANCE_JOINT_H
  19. #define B2_DISTANCE_JOINT_H
  20. #include <Box2D/Dynamics/Joints/b2Joint.h>
  21. /// Distance joint definition. This requires defining an
  22. /// anchor point on both bodies and the non-zero length of the
  23. /// distance joint. The definition uses local anchor points
  24. /// so that the initial configuration can violate the constraint
  25. /// slightly. This helps when saving and loading a game.
  26. /// @warning Do not use a zero or short length.
  27. struct b2DistanceJointDef : public b2JointDef
  28. {
  29. b2DistanceJointDef()
  30. {
  31. type = e_distanceJoint;
  32. localAnchorA.Set(0.0f, 0.0f);
  33. localAnchorB.Set(0.0f, 0.0f);
  34. length = 1.0f;
  35. frequencyHz = 0.0f;
  36. dampingRatio = 0.0f;
  37. }
  38. /// Initialize the bodies, anchors, and length using the world
  39. /// anchors.
  40. void Initialize(b2Body* bodyA, b2Body* bodyB,
  41. const b2Vec2& anchorA, const b2Vec2& anchorB);
  42. /// The local anchor point relative to body1's origin.
  43. b2Vec2 localAnchorA;
  44. /// The local anchor point relative to body2's origin.
  45. b2Vec2 localAnchorB;
  46. /// The natural length between the anchor points.
  47. float32 length;
  48. /// The mass-spring-damper frequency in Hertz.
  49. float32 frequencyHz;
  50. /// The damping ratio. 0 = no damping, 1 = critical damping.
  51. float32 dampingRatio;
  52. };
  53. /// A distance joint constrains two points on two bodies
  54. /// to remain at a fixed distance from each other. You can view
  55. /// this as a massless, rigid rod.
  56. class b2DistanceJoint : public b2Joint
  57. {
  58. public:
  59. b2Vec2 GetAnchorA() const;
  60. b2Vec2 GetAnchorB() const;
  61. b2Vec2 GetReactionForce(float32 inv_dt) const;
  62. float32 GetReactionTorque(float32 inv_dt) const;
  63. /// Set/get the natural length.
  64. /// Manipulating the length can lead to non-physical behavior when the frequency is zero.
  65. void SetLength(float32 length);
  66. float32 GetLength() const;
  67. // Set/get frequency in Hz.
  68. void SetFrequency(float32 hz);
  69. float32 GetFrequency() const;
  70. // Set/get damping ratio.
  71. void SetDampingRatio(float32 ratio);
  72. float32 GetDampingRatio() const;
  73. protected:
  74. friend class b2Joint;
  75. b2DistanceJoint(const b2DistanceJointDef* data);
  76. void InitVelocityConstraints(const b2TimeStep& step);
  77. void SolveVelocityConstraints(const b2TimeStep& step);
  78. bool SolvePositionConstraints(float32 baumgarte);
  79. b2Vec2 m_localAnchor1;
  80. b2Vec2 m_localAnchor2;
  81. b2Vec2 m_u;
  82. float32 m_frequencyHz;
  83. float32 m_dampingRatio;
  84. float32 m_gamma;
  85. float32 m_bias;
  86. float32 m_impulse;
  87. float32 m_mass;
  88. float32 m_length;
  89. };
  90. inline void b2DistanceJoint::SetLength(float32 length)
  91. {
  92. m_length = length;
  93. }
  94. inline float32 b2DistanceJoint::GetLength() const
  95. {
  96. return m_length;
  97. }
  98. inline void b2DistanceJoint::SetFrequency(float32 hz)
  99. {
  100. m_frequencyHz = hz;
  101. }
  102. inline float32 b2DistanceJoint::GetFrequency() const
  103. {
  104. return m_frequencyHz;
  105. }
  106. inline void b2DistanceJoint::SetDampingRatio(float32 ratio)
  107. {
  108. m_dampingRatio = ratio;
  109. }
  110. inline float32 b2DistanceJoint::GetDampingRatio() const
  111. {
  112. return m_dampingRatio;
  113. }
  114. #endif