Skip to content

Commit 0d0e56c

Browse files
committed
Slightly better docs for forces/impulses
1 parent 06aaaa9 commit 0d0e56c

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

pymunk/body.py

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -528,11 +528,16 @@ def apply_force_at_world_point(
528528
) -> None:
529529
"""Add the force force to body as if applied from the world point.
530530
531-
People are sometimes confused by the difference between a force and
532-
an impulse. An impulse is a very large force applied over a very
531+
An impulse is a very large force applied over a very
533532
short period of time. Some examples are a ball hitting a wall or
534533
cannon firing. Chipmunk treats impulses as if they occur
535534
instantaneously by adding directly to the velocity of an object.
535+
536+
Applying the force on the other hand is for things which have effect
537+
over time, such as gravity or air resistance. The force is proprtional
538+
to the time step (meaning it is multiplied with the dt argument to the
539+
step method).
540+
536541
Both impulses and forces are affected the mass of an object. Doubling
537542
the mass of the object will halve the effect.
538543
"""

0 commit comments

Comments
 (0)