1 /*
2 * Copyright (c) 2006-2009 Erin Catto http://www.gphysics.com
3 *
4 * This software is provided 'as-is', without any express or implied
5 * warranty.  In no event will the authors be held liable for any damages
6 * arising from the use of this software.
7 * Permission is granted to anyone to use this software for any purpose,
8 * including commercial applications, and to alter it and redistribute it
9 * freely, subject to the following restrictions:
10 * 1. The origin of this software must not be misrepresented; you must not
11 * claim that you wrote the original software. If you use this software
12 * in a product, an acknowledgment in the product documentation would be
13 * appreciated but is not required.
14 * 2. Altered source versions must be plainly marked as such, and must not be
15 * misrepresented as being the original software.
16 * 3. This notice may not be removed or altered from any source distribution.
17 */
18 
19 #ifndef B2_TIME_OF_IMPACT_H
20 #define B2_TIME_OF_IMPACT_H
21 
22 #include "b2Math.h"
23 #include "b2Distance.h"
24 #include <climits>
25 
26 /// Input parameters for b2TimeOfImpact
27 struct b2TOIInput
28 {
29 	b2DistanceProxy proxyA;
30 	b2DistanceProxy proxyB;
31 	b2Sweep sweepA;
32 	b2Sweep sweepB;
33 	float32 tMax;		// defines sweep interval [0, tMax]
34 };
35 
36 // Output parameters for b2TimeOfImpact.
37 struct b2TOIOutput
38 {
39 	enum State
40 	{
41 		e_unknown,
42 		e_failed,
43 		e_overlapped,
44 		e_touching,
45 		e_separated
46 	};
47 
48 	State state;
49 	float32 t;
50 };
51 
52 /// Compute the upper bound on time before two shapes penetrate. Time is represented as
53 /// a fraction between [0,tMax]. This uses a swept separating axis and may miss some intermediate,
54 /// non-tunneling collision. If you change the time interval, you should call this function
55 /// again.
56 /// Note: use b2Distance to compute the contact point and normal at the time of impact.
57 void b2TimeOfImpact(b2TOIOutput* output, const b2TOIInput* input);
58 
59 #endif
60