What a projectile does after a contact, by the outcome the caller decided:
stick: it stops at the contact, its point carried depth on along its
velocity into the struck body, and rests there;
bounce: it leaves on a new flight from the contact, its velocity's
normal part reversed and scaled by the restitution and its tangential
part reduced by Coulomb friction's impulse, min(mu (1 + e) |v_n|, |v_t|) (the rigid-body impact model of Brach, Mechanical Impact
Dynamics, 1991, ch. 4); when roll is given and the rebound would rise
less than the body's radius above the surface under gravity pressing
toward the surface, it rolls instead;
roll: it rolls along the surface with its velocity's tangential part,
slowed at the rolling-resistance coefficient times the gravity pressing
it on the surface, a = c max(0, -g_n), to rest at v^2 / (2 a);
pass: it continues through on the same flight, losing a share of its
speed.
Every coefficient is the caller's: the engine names no projectile.
Restitution and the lost-speed share are finite values in [0, 1]; friction,
rolling resistance and embedding depth remain finite and nonnegative.
Gravity's pull along a tilted surface is not modelled in a roll, so a roll
on a slope keeps the deceleration of a level one (stated, not hidden).
An explicit roll with outward normal gravity is rejected: an unbound
surface cannot hold that body against gravity. Neutral normal gravity
permits a zero-resistance roll; it does not turn a bounce into one.
The segment that follows, timed from the original flight's launch.
Throws
When the hit has no normal, a coefficient is negative or not finite, restitution or speed loss exceeds one, or an explicit roll would need a surface to pull against outward gravity.
What a projectile does after a contact, by the outcome the caller decided:
stick: it stops at the contact, its point carrieddepthon along its velocity into the struck body, and rests there;bounce: it leaves on a new flight from the contact, its velocity's normal part reversed and scaled by the restitution and its tangential part reduced by Coulomb friction's impulse,min(mu (1 + e) |v_n|, |v_t|)(the rigid-body impact model of Brach, Mechanical Impact Dynamics, 1991, ch. 4); whenrollis given and the rebound would rise less than the body's radius above the surface under gravity pressing toward the surface, it rolls instead;roll: it rolls along the surface with its velocity's tangential part, slowed at the rolling-resistance coefficient times the gravity pressing it on the surface,a = c max(0, -g_n), to rest atv^2 / (2 a);pass: it continues through on the same flight, losing a share of its speed.Every coefficient is the caller's: the engine names no projectile. Restitution and the lost-speed share are finite values in [0, 1]; friction, rolling resistance and embedding depth remain finite and nonnegative. Gravity's pull along a tilted surface is not modelled in a roll, so a roll on a slope keeps the deceleration of a level one (stated, not hidden). An explicit roll with outward normal gravity is rejected: an unbound surface cannot hold that body against gravity. Neutral normal gravity permits a zero-resistance roll; it does not turn a bounce into one.