Difference between revisions of "Body:applyImpulse"

m (1 revision: Imported docs from potato.)
Line 1: Line 1:
  
 +
Applies an impulse to a body.
 +
This makes a single, instantaneous addition to the body momentum.
 +
 +
An impulse pushes a body in a direction. A body with with a larger mass will react less. The reaction does '''not''' depend on the timestep, and is equivalent to applying a force continuously for 1 second. Impulses are best used to give a single push to a body. For a continuous push to a body it is better to use [[Body:applyForce]].
 +
 +
 +
If the position to apply the impulse is not given, it will act on the center of mass of the body. The part of the impulse not directed towards the center of mass will cause the body to spin (and depends on the rotational inertia).
 +
 +
 +
Note that the impulse components and position must be given in world coordinates.
  
 
== Function ==
 
== Function ==
Line 16: Line 26:
 
* [[parent::Body]]
 
* [[parent::Body]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=}}
+
{{#set:Description=Applies an impulse to a body.
 +
}}

Revision as of 16:17, 14 February 2010

Applies an impulse to a body. This makes a single, instantaneous addition to the body momentum.

An impulse pushes a body in a direction. A body with with a larger mass will react less. The reaction does not depend on the timestep, and is equivalent to applying a force continuously for 1 second. Impulses are best used to give a single push to a body. For a continuous push to a body it is better to use Body:applyForce.


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


Note that the impulse components and position must be given in world coordinates.

Function

Synopsis

Body:applyImpulse( ix, iy, x, y )

Arguments

number ix
The x component of the impulse.
number iy
The y component of the impulse.
number x
The x position to apply the impulse.
number y
The y position to apply the impulse.

Returns

Nothing.

See Also