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

游戏引擎

开发平台:

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_TENSORDAMPINGCONTROLLER_H
  19. #define B2_TENSORDAMPINGCONTROLLER_H
  20. #include "b2Controller.h"
  21. class b2TensorDampingControllerDef;
  22. /// Applies top down linear damping to the controlled bodies
  23. /// The damping is calculated by multiplying velocity by a matrix in local co-ordinates.
  24. class b2TensorDampingController : public b2Controller{
  25. public:
  26. /// Tensor to use in damping model
  27. b2Mat22 T;
  28. /*Some examples (matrixes in format (row1; row2) )
  29. (-a 0;0 -a) Standard isotropic damping with strength a
  30. (0 a;-a 0) Electron in fixed field - a force at right angles to velocity with proportional magnitude
  31. (-a 0;0 -b) Differing x and y damping. Useful e.g. for top-down wheels.
  32. */
  33. //By the way, tensor in this case just means matrix, don't let the terminology get you down.
  34. /// Set this to a positive number to clamp the maximum amount of damping done.
  35. float32 maxTimestep;
  36. // Typically one wants maxTimestep to be 1/(max eigenvalue of T), so that damping will never cause something to reverse direction
  37. /// @see b2Controller::Step
  38. void Step(const b2TimeStep& step);
  39. protected:
  40. void Destroy(b2BlockAllocator* allocator);
  41. private:
  42. friend class b2TensorDampingControllerDef;
  43. b2TensorDampingController(const b2TensorDampingControllerDef* def);
  44. };
  45. /// This class is used to build tensor damping controllers
  46. class b2TensorDampingControllerDef : public b2ControllerDef
  47. {
  48. public:
  49. /// Tensor to use in damping model
  50. b2Mat22 T;
  51. /// Set this to a positive number to clamp the maximum amount of damping done.
  52. float32 maxTimestep;
  53. /// Sets damping independantly along the x and y axes
  54. void SetAxisAligned(float32 xDamping,float32 yDamping);
  55. private:
  56. b2TensorDampingController* Create(b2BlockAllocator* allocator) const;
  57. };
  58. #endif