class_angle_constraint_part.html 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=11"/>
  6. <meta name="generator" content="Doxygen 1.12.0"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>Jolt Physics: AngleConstraintPart Class Reference</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <script type="text/javascript" src="clipboard.js"></script>
  13. <link href="navtree.css" rel="stylesheet" type="text/css"/>
  14. <script type="text/javascript" src="navtreedata.js"></script>
  15. <script type="text/javascript" src="navtree.js"></script>
  16. <script type="text/javascript" src="resize.js"></script>
  17. <script type="text/javascript" src="cookie.js"></script>
  18. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  19. <script type="text/javascript" src="search/searchdata.js"></script>
  20. <script type="text/javascript" src="search/search.js"></script>
  21. <script type="text/x-mathjax-config">
  22. MathJax.Hub.Config({
  23. extensions: ["tex2jax.js"],
  24. jax: ["input/TeX","output/HTML-CSS"],
  25. });
  26. </script>
  27. <script type="text/javascript" async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js"></script>
  28. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  29. </head>
  30. <body>
  31. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  32. <div id="titlearea">
  33. <table cellspacing="0" cellpadding="0">
  34. <tbody>
  35. <tr id="projectrow">
  36. <td id="projectlogo"><img alt="Logo" src="LogoSmall.png"/></td>
  37. <td id="projectalign">
  38. <div id="projectname">Jolt Physics
  39. </div>
  40. <div id="projectbrief">A multi core friendly Game Physics Engine</div>
  41. </td>
  42. </tr>
  43. </tbody>
  44. </table>
  45. </div>
  46. <!-- end header part -->
  47. <!-- Generated by Doxygen 1.12.0 -->
  48. <script type="text/javascript">
  49. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  50. var searchBox = new SearchBox("searchBox", "search/",'.html');
  51. /* @license-end */
  52. </script>
  53. <script type="text/javascript">
  54. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  55. $(function() { codefold.init(0); });
  56. /* @license-end */
  57. </script>
  58. <script type="text/javascript" src="menudata.js"></script>
  59. <script type="text/javascript" src="menu.js"></script>
  60. <script type="text/javascript">
  61. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  62. $(function() {
  63. initMenu('',true,false,'search.php','Search',true);
  64. $(function() { init_search(); });
  65. });
  66. /* @license-end */
  67. </script>
  68. <div id="main-nav"></div>
  69. </div><!-- top -->
  70. <div id="side-nav" class="ui-resizable side-nav-resizable">
  71. <div id="nav-tree">
  72. <div id="nav-tree-contents">
  73. <div id="nav-sync" class="sync"></div>
  74. </div>
  75. </div>
  76. <div id="splitbar" style="-moz-user-select:none;"
  77. class="ui-resizable-handle">
  78. </div>
  79. </div>
  80. <script type="text/javascript">
  81. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  82. $(function(){initNavTree('class_angle_constraint_part.html',''); initResizable(true); });
  83. /* @license-end */
  84. </script>
  85. <div id="doc-content">
  86. <!-- window showing the filter options -->
  87. <div id="MSearchSelectWindow"
  88. onmouseover="return searchBox.OnSearchSelectShow()"
  89. onmouseout="return searchBox.OnSearchSelectHide()"
  90. onkeydown="return searchBox.OnSearchSelectKey(event)">
  91. </div>
  92. <!-- iframe showing the search results (closed by default) -->
  93. <div id="MSearchResultsWindow">
  94. <div id="MSearchResults">
  95. <div class="SRPage">
  96. <div id="SRIndex">
  97. <div id="SRResults"></div>
  98. <div class="SRStatus" id="Loading">Loading...</div>
  99. <div class="SRStatus" id="Searching">Searching...</div>
  100. <div class="SRStatus" id="NoMatches">No Matches</div>
  101. </div>
  102. </div>
  103. </div>
  104. </div>
  105. <div class="header">
  106. <div class="summary">
  107. <a href="#pub-methods">Public Member Functions</a> &#124;
  108. <a href="class_angle_constraint_part-members.html">List of all members</a> </div>
  109. <div class="headertitle"><div class="title">AngleConstraintPart Class Reference</div></div>
  110. </div><!--header-->
  111. <div class="contents">
  112. <p><code>#include &lt;<a class="el" href="_angle_constraint_part_8h_source.html">AngleConstraintPart.h</a>&gt;</code></p>
  113. <table class="memberdecls">
  114. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-methods" name="pub-methods"></a>
  115. Public Member Functions</h2></td></tr>
  116. <tr class="memitem:a4db6fb3120c161301e04ee92276544d4" id="r_a4db6fb3120c161301e04ee92276544d4"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a4db6fb3120c161301e04ee92276544d4">CalculateConstraintProperties</a> (const <a class="el" href="class_body.html">Body</a> &amp;inBody1, const <a class="el" href="class_body.html">Body</a> &amp;inBody2, <a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a> inWorldSpaceAxis, float inBias=0.0f)</td></tr>
  117. <tr class="separator:a4db6fb3120c161301e04ee92276544d4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:ace82e23e9129e1c30c93134a2d75504e" id="r_ace82e23e9129e1c30c93134a2d75504e"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ace82e23e9129e1c30c93134a2d75504e">CalculateConstraintPropertiesWithFrequencyAndDamping</a> (float inDeltaTime, const <a class="el" href="class_body.html">Body</a> &amp;inBody1, const <a class="el" href="class_body.html">Body</a> &amp;inBody2, <a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a> inWorldSpaceAxis, float inBias, float inC, float inFrequency, float inDamping)</td></tr>
  119. <tr class="separator:ace82e23e9129e1c30c93134a2d75504e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <tr class="memitem:a13c8d05c1aef17b2edc81da4ea754404" id="r_a13c8d05c1aef17b2edc81da4ea754404"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a13c8d05c1aef17b2edc81da4ea754404">CalculateConstraintPropertiesWithStiffnessAndDamping</a> (float inDeltaTime, const <a class="el" href="class_body.html">Body</a> &amp;inBody1, const <a class="el" href="class_body.html">Body</a> &amp;inBody2, <a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a> inWorldSpaceAxis, float inBias, float inC, float inStiffness, float inDamping)</td></tr>
  121. <tr class="separator:a13c8d05c1aef17b2edc81da4ea754404"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:ac8eb562a067ed5596aca09e04ffc32d1" id="r_ac8eb562a067ed5596aca09e04ffc32d1"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ac8eb562a067ed5596aca09e04ffc32d1">CalculateConstraintPropertiesWithSettings</a> (float inDeltaTime, const <a class="el" href="class_body.html">Body</a> &amp;inBody1, const <a class="el" href="class_body.html">Body</a> &amp;inBody2, <a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a> inWorldSpaceAxis, float inBias, float inC, const <a class="el" href="class_spring_settings.html">SpringSettings</a> &amp;inSpringSettings)</td></tr>
  123. <tr class="memdesc:ac8eb562a067ed5596aca09e04ffc32d1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Selects one of the above functions based on the spring settings. <br /></td></tr>
  124. <tr class="separator:ac8eb562a067ed5596aca09e04ffc32d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  125. <tr class="memitem:a27c8bf9c172f0d3867c1a489aa08c840" id="r_a27c8bf9c172f0d3867c1a489aa08c840"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a27c8bf9c172f0d3867c1a489aa08c840">Deactivate</a> ()</td></tr>
  126. <tr class="memdesc:a27c8bf9c172f0d3867c1a489aa08c840"><td class="mdescLeft">&#160;</td><td class="mdescRight">Deactivate this constraint. <br /></td></tr>
  127. <tr class="separator:a27c8bf9c172f0d3867c1a489aa08c840"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <tr class="memitem:a470e2813d397af02acc6bf8e8373431c" id="r_a470e2813d397af02acc6bf8e8373431c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a470e2813d397af02acc6bf8e8373431c">IsActive</a> () const</td></tr>
  129. <tr class="memdesc:a470e2813d397af02acc6bf8e8373431c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Check if constraint is active. <br /></td></tr>
  130. <tr class="separator:a470e2813d397af02acc6bf8e8373431c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  131. <tr class="memitem:a8b54544706a1005ac865db7c445b76f1" id="r_a8b54544706a1005ac865db7c445b76f1"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a8b54544706a1005ac865db7c445b76f1">WarmStart</a> (<a class="el" href="class_body.html">Body</a> &amp;ioBody1, <a class="el" href="class_body.html">Body</a> &amp;ioBody2, float inWarmStartImpulseRatio)</td></tr>
  132. <tr class="separator:a8b54544706a1005ac865db7c445b76f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  133. <tr class="memitem:aab9cd08fa77ca04f5ab6a6d5cfd78538" id="r_aab9cd08fa77ca04f5ab6a6d5cfd78538"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#aab9cd08fa77ca04f5ab6a6d5cfd78538">SolveVelocityConstraint</a> (<a class="el" href="class_body.html">Body</a> &amp;ioBody1, <a class="el" href="class_body.html">Body</a> &amp;ioBody2, <a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a> inWorldSpaceAxis, float inMinLambda, float inMaxLambda)</td></tr>
  134. <tr class="separator:aab9cd08fa77ca04f5ab6a6d5cfd78538"><td class="memSeparator" colspan="2">&#160;</td></tr>
  135. <tr class="memitem:af482295498d9ca4f6fcdd0c034d0fb90" id="r_af482295498d9ca4f6fcdd0c034d0fb90"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#af482295498d9ca4f6fcdd0c034d0fb90">GetTotalLambda</a> () const</td></tr>
  136. <tr class="memdesc:af482295498d9ca4f6fcdd0c034d0fb90"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return lagrange multiplier. <br /></td></tr>
  137. <tr class="separator:af482295498d9ca4f6fcdd0c034d0fb90"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:a11bb8ed0daf36021dc407fd13cbfde90" id="r_a11bb8ed0daf36021dc407fd13cbfde90"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a11bb8ed0daf36021dc407fd13cbfde90">SolvePositionConstraint</a> (<a class="el" href="class_body.html">Body</a> &amp;ioBody1, <a class="el" href="class_body.html">Body</a> &amp;ioBody2, float inC, float inBaumgarte) const</td></tr>
  139. <tr class="separator:a11bb8ed0daf36021dc407fd13cbfde90"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:ab75081badd77c6854423f45825ff36ce" id="r_ab75081badd77c6854423f45825ff36ce"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ab75081badd77c6854423f45825ff36ce">SaveState</a> (<a class="el" href="class_state_recorder.html">StateRecorder</a> &amp;inStream) const</td></tr>
  141. <tr class="memdesc:ab75081badd77c6854423f45825ff36ce"><td class="mdescLeft">&#160;</td><td class="mdescRight">Save state of this constraint part. <br /></td></tr>
  142. <tr class="separator:ab75081badd77c6854423f45825ff36ce"><td class="memSeparator" colspan="2">&#160;</td></tr>
  143. <tr class="memitem:a80bd3ee7db86967d1a55100ab244d01c" id="r_a80bd3ee7db86967d1a55100ab244d01c"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a80bd3ee7db86967d1a55100ab244d01c">RestoreState</a> (<a class="el" href="class_state_recorder.html">StateRecorder</a> &amp;inStream)</td></tr>
  144. <tr class="memdesc:a80bd3ee7db86967d1a55100ab244d01c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Restore state of this constraint part. <br /></td></tr>
  145. <tr class="separator:a80bd3ee7db86967d1a55100ab244d01c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. </table>
  147. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  148. <div class="textblock"><p><a class="el" href="class_constraint.html" title="Base class for all physics constraints. A constraint removes one or more degrees of freedom for a rig...">Constraint</a> that constrains rotation along 1 axis</p>
  149. <p>Based on: "Constraints Derivation for Rigid Body Simulation in 3D" - Daniel Chappuis, see section 2.4.5</p>
  150. <p><a class="el" href="class_constraint.html" title="Base class for all physics constraints. A constraint removes one or more degrees of freedom for a rig...">Constraint</a> equation (eq 108):</p>
  151. <p class="formulaDsp">
  152. \[C = \theta(t) - \theta_{min}\]
  153. </p>
  154. <p>Jacobian (eq 109):</p>
  155. <p class="formulaDsp">
  156. \[J = \begin{bmatrix}0 &amp; -a^T &amp; 0 &amp; a^T\end{bmatrix}\]
  157. </p>
  158. <p>Used terms (here and below, everything in world space):<br />
  159. a = axis around which rotation is constrained (normalized).<br />
  160. x1, x2 = center of mass for the bodies.<br />
  161. v = [v1, w1, v2, w2].<br />
  162. v1, v2 = linear velocity of body 1 and 2.<br />
  163. w1, w2 = angular velocity of body 1 and 2.<br />
  164. M = mass matrix, a diagonal matrix of the mass and inertia with diagonal [m1, I1, m2, I2].<br />
  165. \(K^{-1} = \left( J M^{-1} J^T \right)^{-1}\) = effective mass.<br />
  166. b = velocity bias.<br />
  167. \(\beta\) = baumgarte constant. </p>
  168. </div><h2 class="groupheader">Member Function Documentation</h2>
  169. <a id="a4db6fb3120c161301e04ee92276544d4" name="a4db6fb3120c161301e04ee92276544d4"></a>
  170. <h2 class="memtitle"><span class="permalink"><a href="#a4db6fb3120c161301e04ee92276544d4">&#9670;&#160;</a></span>CalculateConstraintProperties()</h2>
  171. <div class="memitem">
  172. <div class="memproto">
  173. <table class="mlabels">
  174. <tr>
  175. <td class="mlabels-left">
  176. <table class="memname">
  177. <tr>
  178. <td class="memname">void AngleConstraintPart::CalculateConstraintProperties </td>
  179. <td>(</td>
  180. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody1</em></span>, </td>
  181. </tr>
  182. <tr>
  183. <td class="paramkey"></td>
  184. <td></td>
  185. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody2</em></span>, </td>
  186. </tr>
  187. <tr>
  188. <td class="paramkey"></td>
  189. <td></td>
  190. <td class="paramtype"><a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a></td> <td class="paramname"><span class="paramname"><em>inWorldSpaceAxis</em></span>, </td>
  191. </tr>
  192. <tr>
  193. <td class="paramkey"></td>
  194. <td></td>
  195. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inBias</em></span><span class="paramdefsep"> = </span><span class="paramdefval">0.0f</span>&#160;)</td>
  196. </tr>
  197. </table>
  198. </td>
  199. <td class="mlabels-right">
  200. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  201. </tr>
  202. </table>
  203. </div><div class="memdoc">
  204. <p>Calculate properties used during the functions below </p><dl class="params"><dt>Parameters</dt><dd>
  205. <table class="params">
  206. <tr><td class="paramname">inBody1</td><td>The first body that this constraint is attached to </td></tr>
  207. <tr><td class="paramname">inBody2</td><td>The second body that this constraint is attached to </td></tr>
  208. <tr><td class="paramname">inWorldSpaceAxis</td><td>The axis of rotation along which the constraint acts (normalized) Set the following terms to zero if you don't want to drive the constraint to zero with a spring: </td></tr>
  209. <tr><td class="paramname">inBias</td><td>Bias term (b) for the constraint impulse: lambda = J v + b </td></tr>
  210. </table>
  211. </dd>
  212. </dl>
  213. </div>
  214. </div>
  215. <a id="ace82e23e9129e1c30c93134a2d75504e" name="ace82e23e9129e1c30c93134a2d75504e"></a>
  216. <h2 class="memtitle"><span class="permalink"><a href="#ace82e23e9129e1c30c93134a2d75504e">&#9670;&#160;</a></span>CalculateConstraintPropertiesWithFrequencyAndDamping()</h2>
  217. <div class="memitem">
  218. <div class="memproto">
  219. <table class="mlabels">
  220. <tr>
  221. <td class="mlabels-left">
  222. <table class="memname">
  223. <tr>
  224. <td class="memname">void AngleConstraintPart::CalculateConstraintPropertiesWithFrequencyAndDamping </td>
  225. <td>(</td>
  226. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inDeltaTime</em></span>, </td>
  227. </tr>
  228. <tr>
  229. <td class="paramkey"></td>
  230. <td></td>
  231. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody1</em></span>, </td>
  232. </tr>
  233. <tr>
  234. <td class="paramkey"></td>
  235. <td></td>
  236. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody2</em></span>, </td>
  237. </tr>
  238. <tr>
  239. <td class="paramkey"></td>
  240. <td></td>
  241. <td class="paramtype"><a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a></td> <td class="paramname"><span class="paramname"><em>inWorldSpaceAxis</em></span>, </td>
  242. </tr>
  243. <tr>
  244. <td class="paramkey"></td>
  245. <td></td>
  246. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inBias</em></span>, </td>
  247. </tr>
  248. <tr>
  249. <td class="paramkey"></td>
  250. <td></td>
  251. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inC</em></span>, </td>
  252. </tr>
  253. <tr>
  254. <td class="paramkey"></td>
  255. <td></td>
  256. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inFrequency</em></span>, </td>
  257. </tr>
  258. <tr>
  259. <td class="paramkey"></td>
  260. <td></td>
  261. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inDamping</em></span>&#160;)</td>
  262. </tr>
  263. </table>
  264. </td>
  265. <td class="mlabels-right">
  266. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  267. </tr>
  268. </table>
  269. </div><div class="memdoc">
  270. <p>Calculate properties used during the functions below </p><dl class="params"><dt>Parameters</dt><dd>
  271. <table class="params">
  272. <tr><td class="paramname">inDeltaTime</td><td>Time step </td></tr>
  273. <tr><td class="paramname">inBody1</td><td>The first body that this constraint is attached to </td></tr>
  274. <tr><td class="paramname">inBody2</td><td>The second body that this constraint is attached to </td></tr>
  275. <tr><td class="paramname">inWorldSpaceAxis</td><td>The axis of rotation along which the constraint acts (normalized) Set the following terms to zero if you don't want to drive the constraint to zero with a spring: </td></tr>
  276. <tr><td class="paramname">inBias</td><td>Bias term (b) for the constraint impulse: lambda = J v + b </td></tr>
  277. <tr><td class="paramname">inC</td><td>Value of the constraint equation (C) </td></tr>
  278. <tr><td class="paramname">inFrequency</td><td>Oscillation frequency (Hz) </td></tr>
  279. <tr><td class="paramname">inDamping</td><td>Damping factor (0 = no damping, 1 = critical damping) </td></tr>
  280. </table>
  281. </dd>
  282. </dl>
  283. </div>
  284. </div>
  285. <a id="ac8eb562a067ed5596aca09e04ffc32d1" name="ac8eb562a067ed5596aca09e04ffc32d1"></a>
  286. <h2 class="memtitle"><span class="permalink"><a href="#ac8eb562a067ed5596aca09e04ffc32d1">&#9670;&#160;</a></span>CalculateConstraintPropertiesWithSettings()</h2>
  287. <div class="memitem">
  288. <div class="memproto">
  289. <table class="mlabels">
  290. <tr>
  291. <td class="mlabels-left">
  292. <table class="memname">
  293. <tr>
  294. <td class="memname">void AngleConstraintPart::CalculateConstraintPropertiesWithSettings </td>
  295. <td>(</td>
  296. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inDeltaTime</em></span>, </td>
  297. </tr>
  298. <tr>
  299. <td class="paramkey"></td>
  300. <td></td>
  301. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody1</em></span>, </td>
  302. </tr>
  303. <tr>
  304. <td class="paramkey"></td>
  305. <td></td>
  306. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody2</em></span>, </td>
  307. </tr>
  308. <tr>
  309. <td class="paramkey"></td>
  310. <td></td>
  311. <td class="paramtype"><a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a></td> <td class="paramname"><span class="paramname"><em>inWorldSpaceAxis</em></span>, </td>
  312. </tr>
  313. <tr>
  314. <td class="paramkey"></td>
  315. <td></td>
  316. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inBias</em></span>, </td>
  317. </tr>
  318. <tr>
  319. <td class="paramkey"></td>
  320. <td></td>
  321. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inC</em></span>, </td>
  322. </tr>
  323. <tr>
  324. <td class="paramkey"></td>
  325. <td></td>
  326. <td class="paramtype">const <a class="el" href="class_spring_settings.html">SpringSettings</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inSpringSettings</em></span>&#160;)</td>
  327. </tr>
  328. </table>
  329. </td>
  330. <td class="mlabels-right">
  331. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  332. </tr>
  333. </table>
  334. </div><div class="memdoc">
  335. <p>Selects one of the above functions based on the spring settings. </p>
  336. </div>
  337. </div>
  338. <a id="a13c8d05c1aef17b2edc81da4ea754404" name="a13c8d05c1aef17b2edc81da4ea754404"></a>
  339. <h2 class="memtitle"><span class="permalink"><a href="#a13c8d05c1aef17b2edc81da4ea754404">&#9670;&#160;</a></span>CalculateConstraintPropertiesWithStiffnessAndDamping()</h2>
  340. <div class="memitem">
  341. <div class="memproto">
  342. <table class="mlabels">
  343. <tr>
  344. <td class="mlabels-left">
  345. <table class="memname">
  346. <tr>
  347. <td class="memname">void AngleConstraintPart::CalculateConstraintPropertiesWithStiffnessAndDamping </td>
  348. <td>(</td>
  349. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inDeltaTime</em></span>, </td>
  350. </tr>
  351. <tr>
  352. <td class="paramkey"></td>
  353. <td></td>
  354. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody1</em></span>, </td>
  355. </tr>
  356. <tr>
  357. <td class="paramkey"></td>
  358. <td></td>
  359. <td class="paramtype">const <a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inBody2</em></span>, </td>
  360. </tr>
  361. <tr>
  362. <td class="paramkey"></td>
  363. <td></td>
  364. <td class="paramtype"><a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a></td> <td class="paramname"><span class="paramname"><em>inWorldSpaceAxis</em></span>, </td>
  365. </tr>
  366. <tr>
  367. <td class="paramkey"></td>
  368. <td></td>
  369. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inBias</em></span>, </td>
  370. </tr>
  371. <tr>
  372. <td class="paramkey"></td>
  373. <td></td>
  374. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inC</em></span>, </td>
  375. </tr>
  376. <tr>
  377. <td class="paramkey"></td>
  378. <td></td>
  379. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inStiffness</em></span>, </td>
  380. </tr>
  381. <tr>
  382. <td class="paramkey"></td>
  383. <td></td>
  384. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inDamping</em></span>&#160;)</td>
  385. </tr>
  386. </table>
  387. </td>
  388. <td class="mlabels-right">
  389. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  390. </tr>
  391. </table>
  392. </div><div class="memdoc">
  393. <p>Calculate properties used during the functions below </p><dl class="params"><dt>Parameters</dt><dd>
  394. <table class="params">
  395. <tr><td class="paramname">inDeltaTime</td><td>Time step </td></tr>
  396. <tr><td class="paramname">inBody1</td><td>The first body that this constraint is attached to </td></tr>
  397. <tr><td class="paramname">inBody2</td><td>The second body that this constraint is attached to </td></tr>
  398. <tr><td class="paramname">inWorldSpaceAxis</td><td>The axis of rotation along which the constraint acts (normalized) Set the following terms to zero if you don't want to drive the constraint to zero with a spring: </td></tr>
  399. <tr><td class="paramname">inBias</td><td>Bias term (b) for the constraint impulse: lambda = J v + b </td></tr>
  400. <tr><td class="paramname">inC</td><td>Value of the constraint equation (C) </td></tr>
  401. <tr><td class="paramname">inStiffness</td><td>Spring stiffness k. </td></tr>
  402. <tr><td class="paramname">inDamping</td><td>Spring damping coefficient c. </td></tr>
  403. </table>
  404. </dd>
  405. </dl>
  406. </div>
  407. </div>
  408. <a id="a27c8bf9c172f0d3867c1a489aa08c840" name="a27c8bf9c172f0d3867c1a489aa08c840"></a>
  409. <h2 class="memtitle"><span class="permalink"><a href="#a27c8bf9c172f0d3867c1a489aa08c840">&#9670;&#160;</a></span>Deactivate()</h2>
  410. <div class="memitem">
  411. <div class="memproto">
  412. <table class="mlabels">
  413. <tr>
  414. <td class="mlabels-left">
  415. <table class="memname">
  416. <tr>
  417. <td class="memname">void AngleConstraintPart::Deactivate </td>
  418. <td>(</td>
  419. <td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
  420. <td></td>
  421. </tr>
  422. </table>
  423. </td>
  424. <td class="mlabels-right">
  425. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  426. </tr>
  427. </table>
  428. </div><div class="memdoc">
  429. <p>Deactivate this constraint. </p>
  430. </div>
  431. </div>
  432. <a id="af482295498d9ca4f6fcdd0c034d0fb90" name="af482295498d9ca4f6fcdd0c034d0fb90"></a>
  433. <h2 class="memtitle"><span class="permalink"><a href="#af482295498d9ca4f6fcdd0c034d0fb90">&#9670;&#160;</a></span>GetTotalLambda()</h2>
  434. <div class="memitem">
  435. <div class="memproto">
  436. <table class="mlabels">
  437. <tr>
  438. <td class="mlabels-left">
  439. <table class="memname">
  440. <tr>
  441. <td class="memname">float AngleConstraintPart::GetTotalLambda </td>
  442. <td>(</td>
  443. <td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
  444. <td> const</td>
  445. </tr>
  446. </table>
  447. </td>
  448. <td class="mlabels-right">
  449. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  450. </tr>
  451. </table>
  452. </div><div class="memdoc">
  453. <p>Return lagrange multiplier. </p>
  454. </div>
  455. </div>
  456. <a id="a470e2813d397af02acc6bf8e8373431c" name="a470e2813d397af02acc6bf8e8373431c"></a>
  457. <h2 class="memtitle"><span class="permalink"><a href="#a470e2813d397af02acc6bf8e8373431c">&#9670;&#160;</a></span>IsActive()</h2>
  458. <div class="memitem">
  459. <div class="memproto">
  460. <table class="mlabels">
  461. <tr>
  462. <td class="mlabels-left">
  463. <table class="memname">
  464. <tr>
  465. <td class="memname">bool AngleConstraintPart::IsActive </td>
  466. <td>(</td>
  467. <td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
  468. <td> const</td>
  469. </tr>
  470. </table>
  471. </td>
  472. <td class="mlabels-right">
  473. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  474. </tr>
  475. </table>
  476. </div><div class="memdoc">
  477. <p>Check if constraint is active. </p>
  478. </div>
  479. </div>
  480. <a id="a80bd3ee7db86967d1a55100ab244d01c" name="a80bd3ee7db86967d1a55100ab244d01c"></a>
  481. <h2 class="memtitle"><span class="permalink"><a href="#a80bd3ee7db86967d1a55100ab244d01c">&#9670;&#160;</a></span>RestoreState()</h2>
  482. <div class="memitem">
  483. <div class="memproto">
  484. <table class="mlabels">
  485. <tr>
  486. <td class="mlabels-left">
  487. <table class="memname">
  488. <tr>
  489. <td class="memname">void AngleConstraintPart::RestoreState </td>
  490. <td>(</td>
  491. <td class="paramtype"><a class="el" href="class_state_recorder.html">StateRecorder</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inStream</em></span></td><td>)</td>
  492. <td></td>
  493. </tr>
  494. </table>
  495. </td>
  496. <td class="mlabels-right">
  497. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  498. </tr>
  499. </table>
  500. </div><div class="memdoc">
  501. <p>Restore state of this constraint part. </p>
  502. </div>
  503. </div>
  504. <a id="ab75081badd77c6854423f45825ff36ce" name="ab75081badd77c6854423f45825ff36ce"></a>
  505. <h2 class="memtitle"><span class="permalink"><a href="#ab75081badd77c6854423f45825ff36ce">&#9670;&#160;</a></span>SaveState()</h2>
  506. <div class="memitem">
  507. <div class="memproto">
  508. <table class="mlabels">
  509. <tr>
  510. <td class="mlabels-left">
  511. <table class="memname">
  512. <tr>
  513. <td class="memname">void AngleConstraintPart::SaveState </td>
  514. <td>(</td>
  515. <td class="paramtype"><a class="el" href="class_state_recorder.html">StateRecorder</a> &amp;</td> <td class="paramname"><span class="paramname"><em>inStream</em></span></td><td>)</td>
  516. <td> const</td>
  517. </tr>
  518. </table>
  519. </td>
  520. <td class="mlabels-right">
  521. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  522. </tr>
  523. </table>
  524. </div><div class="memdoc">
  525. <p>Save state of this constraint part. </p>
  526. </div>
  527. </div>
  528. <a id="a11bb8ed0daf36021dc407fd13cbfde90" name="a11bb8ed0daf36021dc407fd13cbfde90"></a>
  529. <h2 class="memtitle"><span class="permalink"><a href="#a11bb8ed0daf36021dc407fd13cbfde90">&#9670;&#160;</a></span>SolvePositionConstraint()</h2>
  530. <div class="memitem">
  531. <div class="memproto">
  532. <table class="mlabels">
  533. <tr>
  534. <td class="mlabels-left">
  535. <table class="memname">
  536. <tr>
  537. <td class="memname">bool AngleConstraintPart::SolvePositionConstraint </td>
  538. <td>(</td>
  539. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody1</em></span>, </td>
  540. </tr>
  541. <tr>
  542. <td class="paramkey"></td>
  543. <td></td>
  544. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody2</em></span>, </td>
  545. </tr>
  546. <tr>
  547. <td class="paramkey"></td>
  548. <td></td>
  549. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inC</em></span>, </td>
  550. </tr>
  551. <tr>
  552. <td class="paramkey"></td>
  553. <td></td>
  554. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inBaumgarte</em></span>&#160;) const</td>
  555. </tr>
  556. </table>
  557. </td>
  558. <td class="mlabels-right">
  559. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  560. </tr>
  561. </table>
  562. </div><div class="memdoc">
  563. <p>Iteratively update the position constraint. Makes sure C(...) == 0. </p><dl class="params"><dt>Parameters</dt><dd>
  564. <table class="params">
  565. <tr><td class="paramname">ioBody1</td><td>The first body that this constraint is attached to </td></tr>
  566. <tr><td class="paramname">ioBody2</td><td>The second body that this constraint is attached to </td></tr>
  567. <tr><td class="paramname">inC</td><td>Value of the constraint equation (C) </td></tr>
  568. <tr><td class="paramname">inBaumgarte</td><td>Baumgarte constant (fraction of the error to correct) </td></tr>
  569. </table>
  570. </dd>
  571. </dl>
  572. </div>
  573. </div>
  574. <a id="aab9cd08fa77ca04f5ab6a6d5cfd78538" name="aab9cd08fa77ca04f5ab6a6d5cfd78538"></a>
  575. <h2 class="memtitle"><span class="permalink"><a href="#aab9cd08fa77ca04f5ab6a6d5cfd78538">&#9670;&#160;</a></span>SolveVelocityConstraint()</h2>
  576. <div class="memitem">
  577. <div class="memproto">
  578. <table class="mlabels">
  579. <tr>
  580. <td class="mlabels-left">
  581. <table class="memname">
  582. <tr>
  583. <td class="memname">bool AngleConstraintPart::SolveVelocityConstraint </td>
  584. <td>(</td>
  585. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody1</em></span>, </td>
  586. </tr>
  587. <tr>
  588. <td class="paramkey"></td>
  589. <td></td>
  590. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody2</em></span>, </td>
  591. </tr>
  592. <tr>
  593. <td class="paramkey"></td>
  594. <td></td>
  595. <td class="paramtype"><a class="el" href="_math_types_8h.html#a6bc57c31f15cea47640b580d03737c68">Vec3Arg</a></td> <td class="paramname"><span class="paramname"><em>inWorldSpaceAxis</em></span>, </td>
  596. </tr>
  597. <tr>
  598. <td class="paramkey"></td>
  599. <td></td>
  600. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inMinLambda</em></span>, </td>
  601. </tr>
  602. <tr>
  603. <td class="paramkey"></td>
  604. <td></td>
  605. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inMaxLambda</em></span>&#160;)</td>
  606. </tr>
  607. </table>
  608. </td>
  609. <td class="mlabels-right">
  610. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  611. </tr>
  612. </table>
  613. </div><div class="memdoc">
  614. <p>Iteratively update the velocity constraint. Makes sure d/dt C(...) = 0, where C is the constraint equation. </p><dl class="params"><dt>Parameters</dt><dd>
  615. <table class="params">
  616. <tr><td class="paramname">ioBody1</td><td>The first body that this constraint is attached to </td></tr>
  617. <tr><td class="paramname">ioBody2</td><td>The second body that this constraint is attached to </td></tr>
  618. <tr><td class="paramname">inWorldSpaceAxis</td><td>The axis of rotation along which the constraint acts (normalized) </td></tr>
  619. <tr><td class="paramname">inMinLambda</td><td>Minimum angular impulse to apply (N m s) </td></tr>
  620. <tr><td class="paramname">inMaxLambda</td><td>Maximum angular impulse to apply (N m s) </td></tr>
  621. </table>
  622. </dd>
  623. </dl>
  624. </div>
  625. </div>
  626. <a id="a8b54544706a1005ac865db7c445b76f1" name="a8b54544706a1005ac865db7c445b76f1"></a>
  627. <h2 class="memtitle"><span class="permalink"><a href="#a8b54544706a1005ac865db7c445b76f1">&#9670;&#160;</a></span>WarmStart()</h2>
  628. <div class="memitem">
  629. <div class="memproto">
  630. <table class="mlabels">
  631. <tr>
  632. <td class="mlabels-left">
  633. <table class="memname">
  634. <tr>
  635. <td class="memname">void AngleConstraintPart::WarmStart </td>
  636. <td>(</td>
  637. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody1</em></span>, </td>
  638. </tr>
  639. <tr>
  640. <td class="paramkey"></td>
  641. <td></td>
  642. <td class="paramtype"><a class="el" href="class_body.html">Body</a> &amp;</td> <td class="paramname"><span class="paramname"><em>ioBody2</em></span>, </td>
  643. </tr>
  644. <tr>
  645. <td class="paramkey"></td>
  646. <td></td>
  647. <td class="paramtype">float</td> <td class="paramname"><span class="paramname"><em>inWarmStartImpulseRatio</em></span>&#160;)</td>
  648. </tr>
  649. </table>
  650. </td>
  651. <td class="mlabels-right">
  652. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  653. </tr>
  654. </table>
  655. </div><div class="memdoc">
  656. <p>Must be called from the WarmStartVelocityConstraint call to apply the previous frame's impulses </p><dl class="params"><dt>Parameters</dt><dd>
  657. <table class="params">
  658. <tr><td class="paramname">ioBody1</td><td>The first body that this constraint is attached to </td></tr>
  659. <tr><td class="paramname">ioBody2</td><td>The second body that this constraint is attached to </td></tr>
  660. <tr><td class="paramname">inWarmStartImpulseRatio</td><td>Ratio of new step to old time step (dt_new / dt_old) for scaling the lagrange multiplier of the previous frame </td></tr>
  661. </table>
  662. </dd>
  663. </dl>
  664. </div>
  665. </div>
  666. <hr/>The documentation for this class was generated from the following file:<ul>
  667. <li>Jolt/Physics/Constraints/ConstraintPart/<a class="el" href="_angle_constraint_part_8h_source.html">AngleConstraintPart.h</a></li>
  668. </ul>
  669. </div><!-- contents -->
  670. </div><!-- doc-content -->
  671. <!-- start footer part -->
  672. <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  673. <ul>
  674. <li class="navelem"><a class="el" href="class_angle_constraint_part.html">AngleConstraintPart</a></li>
  675. <li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.12.0 </li>
  676. </ul>
  677. </div>
  678. </body>
  679. </html>