class_physicsdirectbodystate2d.rst 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/PhysicsDirectBodyState2D.xml.
  6. .. _class_PhysicsDirectBodyState2D:
  7. PhysicsDirectBodyState2D
  8. ========================
  9. **Inherits:** :ref:`Object<class_Object>`
  10. Direct access object to a physics body in the :ref:`PhysicsServer2D<class_PhysicsServer2D>`.
  11. Description
  12. -----------
  13. Provides direct access to a physics body in the :ref:`PhysicsServer2D<class_PhysicsServer2D>`, allowing safe changes to physics properties. This object is passed via the direct state callback of dynamic bodies, and is intended for changing the direct state of that body. See :ref:`RigidDynamicBody2D._integrate_forces<class_RigidDynamicBody2D_method__integrate_forces>`.
  14. Tutorials
  15. ---------
  16. - :doc:`Physics introduction <../tutorials/physics/physics_introduction>`
  17. - :doc:`Ray-casting <../tutorials/physics/ray-casting>`
  18. Properties
  19. ----------
  20. +---------------------------------------+-------------------------------------------------------------------------------------------+
  21. | :ref:`float<class_float>` | :ref:`angular_velocity<class_PhysicsDirectBodyState2D_property_angular_velocity>` |
  22. +---------------------------------------+-------------------------------------------------------------------------------------------+
  23. | :ref:`Vector2<class_Vector2>` | :ref:`center_of_mass<class_PhysicsDirectBodyState2D_property_center_of_mass>` |
  24. +---------------------------------------+-------------------------------------------------------------------------------------------+
  25. | :ref:`Vector2<class_Vector2>` | :ref:`center_of_mass_local<class_PhysicsDirectBodyState2D_property_center_of_mass_local>` |
  26. +---------------------------------------+-------------------------------------------------------------------------------------------+
  27. | :ref:`float<class_float>` | :ref:`inverse_inertia<class_PhysicsDirectBodyState2D_property_inverse_inertia>` |
  28. +---------------------------------------+-------------------------------------------------------------------------------------------+
  29. | :ref:`float<class_float>` | :ref:`inverse_mass<class_PhysicsDirectBodyState2D_property_inverse_mass>` |
  30. +---------------------------------------+-------------------------------------------------------------------------------------------+
  31. | :ref:`Vector2<class_Vector2>` | :ref:`linear_velocity<class_PhysicsDirectBodyState2D_property_linear_velocity>` |
  32. +---------------------------------------+-------------------------------------------------------------------------------------------+
  33. | :ref:`bool<class_bool>` | :ref:`sleeping<class_PhysicsDirectBodyState2D_property_sleeping>` |
  34. +---------------------------------------+-------------------------------------------------------------------------------------------+
  35. | :ref:`float<class_float>` | :ref:`step<class_PhysicsDirectBodyState2D_property_step>` |
  36. +---------------------------------------+-------------------------------------------------------------------------------------------+
  37. | :ref:`float<class_float>` | :ref:`total_angular_damp<class_PhysicsDirectBodyState2D_property_total_angular_damp>` |
  38. +---------------------------------------+-------------------------------------------------------------------------------------------+
  39. | :ref:`Vector2<class_Vector2>` | :ref:`total_gravity<class_PhysicsDirectBodyState2D_property_total_gravity>` |
  40. +---------------------------------------+-------------------------------------------------------------------------------------------+
  41. | :ref:`float<class_float>` | :ref:`total_linear_damp<class_PhysicsDirectBodyState2D_property_total_linear_damp>` |
  42. +---------------------------------------+-------------------------------------------------------------------------------------------+
  43. | :ref:`Transform2D<class_Transform2D>` | :ref:`transform<class_PhysicsDirectBodyState2D_property_transform>` |
  44. +---------------------------------------+-------------------------------------------------------------------------------------------+
  45. Methods
  46. -------
  47. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | void | :ref:`add_constant_central_force<class_PhysicsDirectBodyState2D_method_add_constant_central_force>` **(** :ref:`Vector2<class_Vector2>` force=Vector2(0, 0) **)** |
  49. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | void | :ref:`add_constant_force<class_PhysicsDirectBodyState2D_method_add_constant_force>` **(** :ref:`Vector2<class_Vector2>` force, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)** |
  51. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | void | :ref:`add_constant_torque<class_PhysicsDirectBodyState2D_method_add_constant_torque>` **(** :ref:`float<class_float>` torque **)** |
  53. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | void | :ref:`apply_central_force<class_PhysicsDirectBodyState2D_method_apply_central_force>` **(** :ref:`Vector2<class_Vector2>` force=Vector2(0, 0) **)** |
  55. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | void | :ref:`apply_central_impulse<class_PhysicsDirectBodyState2D_method_apply_central_impulse>` **(** :ref:`Vector2<class_Vector2>` impulse **)** |
  57. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | void | :ref:`apply_force<class_PhysicsDirectBodyState2D_method_apply_force>` **(** :ref:`Vector2<class_Vector2>` force, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)** |
  59. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | void | :ref:`apply_impulse<class_PhysicsDirectBodyState2D_method_apply_impulse>` **(** :ref:`Vector2<class_Vector2>` impulse, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)** |
  61. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | void | :ref:`apply_torque<class_PhysicsDirectBodyState2D_method_apply_torque>` **(** :ref:`float<class_float>` torque **)** |
  63. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | void | :ref:`apply_torque_impulse<class_PhysicsDirectBodyState2D_method_apply_torque_impulse>` **(** :ref:`float<class_float>` impulse **)** |
  65. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`Vector2<class_Vector2>` | :ref:`get_constant_force<class_PhysicsDirectBodyState2D_method_get_constant_force>` **(** **)** |const| |
  67. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`float<class_float>` | :ref:`get_constant_torque<class_PhysicsDirectBodyState2D_method_get_constant_torque>` **(** **)** |const| |
  69. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`RID<class_RID>` | :ref:`get_contact_collider<class_PhysicsDirectBodyState2D_method_get_contact_collider>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  71. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | :ref:`int<class_int>` | :ref:`get_contact_collider_id<class_PhysicsDirectBodyState2D_method_get_contact_collider_id>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  73. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`Object<class_Object>` | :ref:`get_contact_collider_object<class_PhysicsDirectBodyState2D_method_get_contact_collider_object>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  75. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | :ref:`Vector2<class_Vector2>` | :ref:`get_contact_collider_position<class_PhysicsDirectBodyState2D_method_get_contact_collider_position>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  77. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | :ref:`int<class_int>` | :ref:`get_contact_collider_shape<class_PhysicsDirectBodyState2D_method_get_contact_collider_shape>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  79. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector2<class_Vector2>` | :ref:`get_contact_collider_velocity_at_position<class_PhysicsDirectBodyState2D_method_get_contact_collider_velocity_at_position>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  81. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  82. | :ref:`int<class_int>` | :ref:`get_contact_count<class_PhysicsDirectBodyState2D_method_get_contact_count>` **(** **)** |const| |
  83. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector2<class_Vector2>` | :ref:`get_contact_local_normal<class_PhysicsDirectBodyState2D_method_get_contact_local_normal>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  85. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Vector2<class_Vector2>` | :ref:`get_contact_local_position<class_PhysicsDirectBodyState2D_method_get_contact_local_position>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  87. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | :ref:`int<class_int>` | :ref:`get_contact_local_shape<class_PhysicsDirectBodyState2D_method_get_contact_local_shape>` **(** :ref:`int<class_int>` contact_idx **)** |const| |
  89. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | :ref:`PhysicsDirectSpaceState2D<class_PhysicsDirectSpaceState2D>` | :ref:`get_space_state<class_PhysicsDirectBodyState2D_method_get_space_state>` **(** **)** |
  91. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector2<class_Vector2>` | :ref:`get_velocity_at_local_position<class_PhysicsDirectBodyState2D_method_get_velocity_at_local_position>` **(** :ref:`Vector2<class_Vector2>` local_position **)** |const| |
  93. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  94. | void | :ref:`integrate_forces<class_PhysicsDirectBodyState2D_method_integrate_forces>` **(** **)** |
  95. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  96. | void | :ref:`set_constant_force<class_PhysicsDirectBodyState2D_method_set_constant_force>` **(** :ref:`Vector2<class_Vector2>` force **)** |
  97. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  98. | void | :ref:`set_constant_torque<class_PhysicsDirectBodyState2D_method_set_constant_torque>` **(** :ref:`float<class_float>` torque **)** |
  99. +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  100. Property Descriptions
  101. ---------------------
  102. .. _class_PhysicsDirectBodyState2D_property_angular_velocity:
  103. - :ref:`float<class_float>` **angular_velocity**
  104. +----------+-----------------------------+
  105. | *Setter* | set_angular_velocity(value) |
  106. +----------+-----------------------------+
  107. | *Getter* | get_angular_velocity() |
  108. +----------+-----------------------------+
  109. The body's rotational velocity in *radians* per second.
  110. ----
  111. .. _class_PhysicsDirectBodyState2D_property_center_of_mass:
  112. - :ref:`Vector2<class_Vector2>` **center_of_mass**
  113. +----------+----------------------+
  114. | *Getter* | get_center_of_mass() |
  115. +----------+----------------------+
  116. The body's center of mass position relative to the body's center in the global coordinate system.
  117. ----
  118. .. _class_PhysicsDirectBodyState2D_property_center_of_mass_local:
  119. - :ref:`Vector2<class_Vector2>` **center_of_mass_local**
  120. +----------+----------------------------+
  121. | *Getter* | get_center_of_mass_local() |
  122. +----------+----------------------------+
  123. The body's center of mass position in the body's local coordinate system.
  124. ----
  125. .. _class_PhysicsDirectBodyState2D_property_inverse_inertia:
  126. - :ref:`float<class_float>` **inverse_inertia**
  127. +----------+-----------------------+
  128. | *Getter* | get_inverse_inertia() |
  129. +----------+-----------------------+
  130. The inverse of the inertia of the body.
  131. ----
  132. .. _class_PhysicsDirectBodyState2D_property_inverse_mass:
  133. - :ref:`float<class_float>` **inverse_mass**
  134. +----------+--------------------+
  135. | *Getter* | get_inverse_mass() |
  136. +----------+--------------------+
  137. The inverse of the mass of the body.
  138. ----
  139. .. _class_PhysicsDirectBodyState2D_property_linear_velocity:
  140. - :ref:`Vector2<class_Vector2>` **linear_velocity**
  141. +----------+----------------------------+
  142. | *Setter* | set_linear_velocity(value) |
  143. +----------+----------------------------+
  144. | *Getter* | get_linear_velocity() |
  145. +----------+----------------------------+
  146. The body's linear velocity in pixels per second.
  147. ----
  148. .. _class_PhysicsDirectBodyState2D_property_sleeping:
  149. - :ref:`bool<class_bool>` **sleeping**
  150. +----------+------------------------+
  151. | *Setter* | set_sleep_state(value) |
  152. +----------+------------------------+
  153. | *Getter* | is_sleeping() |
  154. +----------+------------------------+
  155. If ``true``, this body is currently sleeping (not active).
  156. ----
  157. .. _class_PhysicsDirectBodyState2D_property_step:
  158. - :ref:`float<class_float>` **step**
  159. +----------+------------+
  160. | *Getter* | get_step() |
  161. +----------+------------+
  162. The timestep (delta) used for the simulation.
  163. ----
  164. .. _class_PhysicsDirectBodyState2D_property_total_angular_damp:
  165. - :ref:`float<class_float>` **total_angular_damp**
  166. +----------+--------------------------+
  167. | *Getter* | get_total_angular_damp() |
  168. +----------+--------------------------+
  169. The rate at which the body stops rotating, if there are not any other forces moving it.
  170. ----
  171. .. _class_PhysicsDirectBodyState2D_property_total_gravity:
  172. - :ref:`Vector2<class_Vector2>` **total_gravity**
  173. +----------+---------------------+
  174. | *Getter* | get_total_gravity() |
  175. +----------+---------------------+
  176. The total gravity vector being currently applied to this body.
  177. ----
  178. .. _class_PhysicsDirectBodyState2D_property_total_linear_damp:
  179. - :ref:`float<class_float>` **total_linear_damp**
  180. +----------+-------------------------+
  181. | *Getter* | get_total_linear_damp() |
  182. +----------+-------------------------+
  183. The rate at which the body stops moving, if there are not any other forces moving it.
  184. ----
  185. .. _class_PhysicsDirectBodyState2D_property_transform:
  186. - :ref:`Transform2D<class_Transform2D>` **transform**
  187. +----------+----------------------+
  188. | *Setter* | set_transform(value) |
  189. +----------+----------------------+
  190. | *Getter* | get_transform() |
  191. +----------+----------------------+
  192. The body's transformation matrix.
  193. Method Descriptions
  194. -------------------
  195. .. _class_PhysicsDirectBodyState2D_method_add_constant_central_force:
  196. - void **add_constant_central_force** **(** :ref:`Vector2<class_Vector2>` force=Vector2(0, 0) **)**
  197. Adds a constant directional force without affecting rotation that keeps being applied over time until cleared with ``constant_force = Vector2(0, 0)``.
  198. This is equivalent to using :ref:`add_constant_force<class_PhysicsDirectBodyState2D_method_add_constant_force>` at the body's center of mass.
  199. ----
  200. .. _class_PhysicsDirectBodyState2D_method_add_constant_force:
  201. - void **add_constant_force** **(** :ref:`Vector2<class_Vector2>` force, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)**
  202. Adds a constant positioned force to the body that keeps being applied over time until cleared with ``constant_force = Vector2(0, 0)``.
  203. \ ``position`` is the offset from the body origin in global coordinates.
  204. ----
  205. .. _class_PhysicsDirectBodyState2D_method_add_constant_torque:
  206. - void **add_constant_torque** **(** :ref:`float<class_float>` torque **)**
  207. Adds a constant rotational force without affecting position that keeps being applied over time until cleared with ``constant_torque = 0``.
  208. ----
  209. .. _class_PhysicsDirectBodyState2D_method_apply_central_force:
  210. - void **apply_central_force** **(** :ref:`Vector2<class_Vector2>` force=Vector2(0, 0) **)**
  211. Applies a directional force without affecting rotation. A force is time dependent and meant to be applied every physics update.
  212. This is equivalent to using :ref:`apply_force<class_PhysicsDirectBodyState2D_method_apply_force>` at the body's center of mass.
  213. ----
  214. .. _class_PhysicsDirectBodyState2D_method_apply_central_impulse:
  215. - void **apply_central_impulse** **(** :ref:`Vector2<class_Vector2>` impulse **)**
  216. Applies a directional impulse without affecting rotation.
  217. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise).
  218. This is equivalent to using :ref:`apply_impulse<class_PhysicsDirectBodyState2D_method_apply_impulse>` at the body's center of mass.
  219. ----
  220. .. _class_PhysicsDirectBodyState2D_method_apply_force:
  221. - void **apply_force** **(** :ref:`Vector2<class_Vector2>` force, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)**
  222. Applies a positioned force to the body. A force is time dependent and meant to be applied every physics update.
  223. \ ``position`` is the offset from the body origin in global coordinates.
  224. ----
  225. .. _class_PhysicsDirectBodyState2D_method_apply_impulse:
  226. - void **apply_impulse** **(** :ref:`Vector2<class_Vector2>` impulse, :ref:`Vector2<class_Vector2>` position=Vector2(0, 0) **)**
  227. Applies a positioned impulse to the body.
  228. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise).
  229. \ ``position`` is the offset from the body origin in global coordinates.
  230. ----
  231. .. _class_PhysicsDirectBodyState2D_method_apply_torque:
  232. - void **apply_torque** **(** :ref:`float<class_float>` torque **)**
  233. Applies a rotational force without affecting position. A force is time dependent and meant to be applied every physics update.
  234. ----
  235. .. _class_PhysicsDirectBodyState2D_method_apply_torque_impulse:
  236. - void **apply_torque_impulse** **(** :ref:`float<class_float>` impulse **)**
  237. Applies a rotational impulse to the body without affecting the position.
  238. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise).
  239. ----
  240. .. _class_PhysicsDirectBodyState2D_method_get_constant_force:
  241. - :ref:`Vector2<class_Vector2>` **get_constant_force** **(** **)** |const|
  242. Returns the body's total constant positional forces applied during each physics update.
  243. See :ref:`add_constant_force<class_PhysicsDirectBodyState2D_method_add_constant_force>` and :ref:`add_constant_central_force<class_PhysicsDirectBodyState2D_method_add_constant_central_force>`.
  244. ----
  245. .. _class_PhysicsDirectBodyState2D_method_get_constant_torque:
  246. - :ref:`float<class_float>` **get_constant_torque** **(** **)** |const|
  247. Returns the body's total constant rotational forces applied during each physics update.
  248. See :ref:`add_constant_torque<class_PhysicsDirectBodyState2D_method_add_constant_torque>`.
  249. ----
  250. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider:
  251. - :ref:`RID<class_RID>` **get_contact_collider** **(** :ref:`int<class_int>` contact_idx **)** |const|
  252. Returns the collider's :ref:`RID<class_RID>`.
  253. ----
  254. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider_id:
  255. - :ref:`int<class_int>` **get_contact_collider_id** **(** :ref:`int<class_int>` contact_idx **)** |const|
  256. Returns the collider's object id.
  257. ----
  258. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider_object:
  259. - :ref:`Object<class_Object>` **get_contact_collider_object** **(** :ref:`int<class_int>` contact_idx **)** |const|
  260. Returns the collider object. This depends on how it was created (will return a scene node if such was used to create it).
  261. ----
  262. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider_position:
  263. - :ref:`Vector2<class_Vector2>` **get_contact_collider_position** **(** :ref:`int<class_int>` contact_idx **)** |const|
  264. Returns the contact position in the collider.
  265. ----
  266. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider_shape:
  267. - :ref:`int<class_int>` **get_contact_collider_shape** **(** :ref:`int<class_int>` contact_idx **)** |const|
  268. Returns the collider's shape index.
  269. ----
  270. .. _class_PhysicsDirectBodyState2D_method_get_contact_collider_velocity_at_position:
  271. - :ref:`Vector2<class_Vector2>` **get_contact_collider_velocity_at_position** **(** :ref:`int<class_int>` contact_idx **)** |const|
  272. Returns the linear velocity vector at the collider's contact point.
  273. ----
  274. .. _class_PhysicsDirectBodyState2D_method_get_contact_count:
  275. - :ref:`int<class_int>` **get_contact_count** **(** **)** |const|
  276. Returns the number of contacts this body has with other bodies.
  277. \ **Note:** By default, this returns 0 unless bodies are configured to monitor contacts. See :ref:`RigidDynamicBody2D.contact_monitor<class_RigidDynamicBody2D_property_contact_monitor>`.
  278. ----
  279. .. _class_PhysicsDirectBodyState2D_method_get_contact_local_normal:
  280. - :ref:`Vector2<class_Vector2>` **get_contact_local_normal** **(** :ref:`int<class_int>` contact_idx **)** |const|
  281. Returns the local normal at the contact point.
  282. ----
  283. .. _class_PhysicsDirectBodyState2D_method_get_contact_local_position:
  284. - :ref:`Vector2<class_Vector2>` **get_contact_local_position** **(** :ref:`int<class_int>` contact_idx **)** |const|
  285. Returns the local position of the contact point.
  286. ----
  287. .. _class_PhysicsDirectBodyState2D_method_get_contact_local_shape:
  288. - :ref:`int<class_int>` **get_contact_local_shape** **(** :ref:`int<class_int>` contact_idx **)** |const|
  289. Returns the local shape index of the collision.
  290. ----
  291. .. _class_PhysicsDirectBodyState2D_method_get_space_state:
  292. - :ref:`PhysicsDirectSpaceState2D<class_PhysicsDirectSpaceState2D>` **get_space_state** **(** **)**
  293. Returns the current state of the space, useful for queries.
  294. ----
  295. .. _class_PhysicsDirectBodyState2D_method_get_velocity_at_local_position:
  296. - :ref:`Vector2<class_Vector2>` **get_velocity_at_local_position** **(** :ref:`Vector2<class_Vector2>` local_position **)** |const|
  297. Returns the body's velocity at the given relative position, including both translation and rotation.
  298. ----
  299. .. _class_PhysicsDirectBodyState2D_method_integrate_forces:
  300. - void **integrate_forces** **(** **)**
  301. Calls the built-in force integration code.
  302. ----
  303. .. _class_PhysicsDirectBodyState2D_method_set_constant_force:
  304. - void **set_constant_force** **(** :ref:`Vector2<class_Vector2>` force **)**
  305. Sets the body's total constant positional forces applied during each physics update.
  306. See :ref:`add_constant_force<class_PhysicsDirectBodyState2D_method_add_constant_force>` and :ref:`add_constant_central_force<class_PhysicsDirectBodyState2D_method_add_constant_central_force>`.
  307. ----
  308. .. _class_PhysicsDirectBodyState2D_method_set_constant_torque:
  309. - void **set_constant_torque** **(** :ref:`float<class_float>` torque **)**
  310. Sets the body's total constant rotational forces applied during each physics update.
  311. See :ref:`add_constant_torque<class_PhysicsDirectBodyState2D_method_add_constant_torque>`.
  312. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  313. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  314. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  315. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  316. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  317. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`