Apply force to a Body.

A force pushes a body in a direction. A body with with a larger mass will react less. The reaction also depends on how long a force is applied: since the force acts continuously over the entire timestep, a short timestep will only push the body for a short time. Thus forces are best used for many timesteps to give a continuous push to a body (like gravity). For a single push that is independent of timestep, it is better to use [[Body:applyLinearImpulse]].


If the position to apply the force is not given, it will act on the center of mass of the body. The part of the force not directed towards the center of mass will cause the body to spin (and depends on the rotational inertia).

Note that the force components and position must be given in world coordinates.
== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
Body:applyForce( fx, fy )
</source>
=== Arguments ===
{{param|number|fx|The x component of force to apply to the center of mass.}}
{{param|number|fy|The y component of force to apply to the center of mass.}}
=== Returns ===
Nothing.

== Function ==
=== Synopsis ===
<source lang="lua">
Body:applyForce( fx, fy, x, y )
</source>
=== Arguments ===
{{param|number|fx|The x component of force to apply.}}
{{param|number|fy|The y component of force to apply.}}
{{param|number|x|The x position to apply the force.}}
{{param|number|y|The y position to apply the force.}}
=== Returns ===
Nothing.

== See Also ==
* [[parent::Body]]
* [[Body:applyTorque]]
* [[Body:applyLinearImpulse]]
[[Category:Functions]]
{{#set:Description=Apply force to a Body.}}
{{#set:Since=000}}

== Other Languages ==
{{i18n|Body:applyForce}}