class_physicsdirectbodystate2d.rst 31 KB

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