Removed collision_prefernudgedfraction cvar and trace.realfraction field, this has...
[xonotic/darkplaces.git] / collision.h
1
2 #ifndef COLLISION_H
3 #define COLLISION_H
4
5 typedef struct plane_s
6 {
7         vec3_t  normal;
8         float   dist;
9 }
10 plane_t;
11
12 struct texture_s;
13 typedef struct trace_s
14 {
15         // if true, the entire trace was in solid (see hitsupercontentsmask)
16         int allsolid;
17         // if true, the initial point was in solid (see hitsupercontentsmask)
18         int startsolid;
19         // this is set to true in world.c if startsolid was set in a trace against world
20         int worldstartsolid;
21         // this is set to true in world.c if startsolid was set in a trace against a SOLID_BSP entity, in other words this is true if the entity is stuck in a door or wall, but not if stuck in another normal entity
22         int bmodelstartsolid;
23         // if true, the trace passed through empty somewhere
24         // (set only by Q1BSP tracing)
25         int inopen;
26         // if true, the trace passed through water/slime/lava somewhere
27         // (set only by Q1BSP tracing)
28         int inwater;
29         // fraction of the total distance that was traveled before impact
30         // in case of impact this is actually nudged a bit off the surface
31         // (1.0 = did not hit anything)
32         double fraction;
33         // final position of the trace (simply a point between start and end)
34         double endpos[3];
35         // surface normal at impact (not really correct for edge collisions)
36         plane_t plane;
37         // entity the surface is on
38         // (not set by trace functions, only by physics)
39         void *ent;
40         // which SUPERCONTENTS bits to collide with, I.E. to consider solid
41         // (this also affects startsolid/allsolid)
42         int hitsupercontentsmask;
43         // the supercontents mask at the start point
44         int startsupercontents;
45         // the supercontents of the impacted surface
46         int hitsupercontents;
47         // the q3 surfaceflags of the impacted surface
48         int hitq3surfaceflags;
49         // the texture of the impacted surface
50         const struct texture_s *hittexture;
51         // initially false, set when the start leaf is found
52         // (set only by Q1BSP tracing and entity box tracing)
53         int startfound;
54         // if startsolid, contains the minimum penetration depth found in the
55         // trace, and the normal needed to push it out of that solid
56         double startdepth;
57         double startdepthnormal[3];
58 }
59 trace_t;
60
61 void Collision_Init(void);
62 void Collision_ClipTrace_Box(trace_t *trace, const vec3_t cmins, const vec3_t cmaxs, const vec3_t start, const vec3_t mins, const vec3_t maxs, const vec3_t end, int hitsupercontentsmask, int boxsupercontents, int boxq3surfaceflags, const texture_t *boxtexture);
63 void Collision_ClipTrace_Point(trace_t *trace, const vec3_t cmins, const vec3_t cmaxs, const vec3_t start, int hitsupercontentsmask, int boxsupercontents, int boxq3surfaceflags, const texture_t *boxtexture);
64
65 void Collision_Cache_Reset(qboolean resetlimits);
66 void Collision_Cache_Init(mempool_t *mempool);
67 void Collision_Cache_NewFrame(void);
68
69 typedef struct colpointf_s
70 {
71         vec3_t v;
72 }
73 colpointf_t;
74
75 typedef struct colplanef_s
76 {
77         const struct texture_s *texture;
78         int q3surfaceflags;
79         vec3_t normal;
80         vec_t dist;
81 }
82 colplanef_t;
83
84 typedef struct colbrushf_s
85 {
86         // culling box
87         vec3_t mins;
88         vec3_t maxs;
89         // used to avoid tracing against the same brush more than once per sweep
90         int markframe;
91         // the content flags of this brush
92         int supercontents;
93         // bounding planes (face planes) of this brush
94         int numplanes;
95         colplanef_t *planes;
96         // edge directions (normals) of this brush
97         int numedgedirs;
98         colpointf_t *edgedirs;
99         // points (corners) of this brush
100         int numpoints;
101         colpointf_t *points;
102         // renderable triangles representing this brush, using the points
103         int numtriangles;
104         int *elements;
105         // texture data for cases where an edgedir is used
106         const struct texture_s *texture;
107         int q3surfaceflags;
108         // optimized collisions for common cases
109         int isaabb; // indicates this is an axis aligned box
110         int hasaabbplanes; // indicates this has precomputed planes for AABB collisions
111 }
112 colbrushf_t;
113
114 typedef struct colboxbrushf_s
115 {
116         colpointf_t points[8];
117         colpointf_t edgedirs[6];
118         colplanef_t planes[6];
119         colbrushf_t brush;
120 }
121 colboxbrushf_t;
122
123 void Collision_CalcPlanesForTriangleBrushFloat(colbrushf_t *brush);
124 colbrushf_t *Collision_AllocBrushFromPermanentPolygonFloat(mempool_t *mempool, int numpoints, float *points, int supercontents, int q3surfaceflags, const texture_t *texture);
125 colbrushf_t *Collision_NewBrushFromPlanes(mempool_t *mempool, int numoriginalplanes, const colplanef_t *originalplanes, int supercontents, int q3surfaceflags, const texture_t *texture, int hasaabbplanes);
126 void Collision_TraceBrushBrushFloat(trace_t *trace, const colbrushf_t *thisbrush_start, const colbrushf_t *thisbrush_end, const colbrushf_t *thatbrush_start, const colbrushf_t *thatbrush_end);
127 void Collision_TraceBrushTriangleMeshFloat(trace_t *trace, const colbrushf_t *thisbrush_start, const colbrushf_t *thisbrush_end, int numtriangles, const int *element3i, const float *vertex3f, int stride, float *bbox6f, int supercontents, int q3surfaceflags, const texture_t *texture, const vec3_t segmentmins, const vec3_t segmentmaxs);
128 void Collision_TraceLineBrushFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, const colbrushf_t *thatbrush_start, const colbrushf_t *thatbrush_end);
129 void Collision_TraceLineTriangleMeshFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, int numtriangles, const int *element3i, const float *vertex3f, int stride, float *bbox6f, int supercontents, int q3surfaceflags, const texture_t *texture, const vec3_t segmentmins, const vec3_t segmentmaxs);
130 void Collision_TracePointBrushFloat(trace_t *trace, const vec3_t point, const colbrushf_t *thatbrush);
131 qboolean Collision_PointInsideBrushFloat(const vec3_t point, const colbrushf_t *brush);
132
133 void Collision_BrushForBox(colboxbrushf_t *boxbrush, const vec3_t mins, const vec3_t maxs, int supercontents, int q3surfaceflags, const texture_t *texture);
134
135 void Collision_BoundingBoxOfBrushTraceSegment(const colbrushf_t *start, const colbrushf_t *end, vec3_t mins, vec3_t maxs, float startfrac, float endfrac);
136
137 float Collision_ClipTrace_Line_Sphere(double *linestart, double *lineend, double *sphereorigin, double sphereradius, double *impactpoint, double *impactnormal);
138 void Collision_TraceLineTriangleFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, const float *point0, const float *point1, const float *point2, int supercontents, int q3surfaceflags, const texture_t *texture);
139 void Collision_TraceBrushTriangleFloat(trace_t *trace, const colbrushf_t *thisbrush_start, const colbrushf_t *thisbrush_end, const float *v0, const float *v1, const float *v2, int supercontents, int q3surfaceflags, const texture_t *texture);
140
141 // traces a box move against a single entity
142 // mins and maxs are relative
143 //
144 // if the entire move stays in a single solid brush, trace.allsolid will be set
145 //
146 // if the starting point is in a solid, it will be allowed to move out to an
147 // open area, and trace.startsolid will be set
148 //
149 // type is one of the MOVE_ values such as MOVE_NOMONSTERS which skips box
150 // entities, only colliding with SOLID_BSP entities (doors, lifts)
151 //
152 // passedict is excluded from clipping checks
153 struct frameblend_s;
154 struct skeleton_s;
155 void Collision_ClipToGenericEntity(trace_t *trace, dp_model_t *model, const struct frameblend_s *frameblend, const struct skeleton_s *skeleton, const vec3_t bodymins, const vec3_t bodymaxs, int bodysupercontents, matrix4x4_t *matrix, matrix4x4_t *inversematrix, const vec3_t start, const vec3_t mins, const vec3_t maxs, const vec3_t end, int hitsupercontentsmask, float extend);
156 void Collision_ClipLineToGenericEntity(trace_t *trace, dp_model_t *model, const struct frameblend_s *frameblend, const struct skeleton_s *skeleton, const vec3_t bodymins, const vec3_t bodymaxs, int bodysupercontents, matrix4x4_t *matrix, matrix4x4_t *inversematrix, const vec3_t start, const vec3_t end, int hitsupercontentsmask, float extend, qboolean hitsurfaces);
157 void Collision_ClipPointToGenericEntity(trace_t *trace, dp_model_t *model, const struct frameblend_s *frameblend, const struct skeleton_s *skeleton, const vec3_t bodymins, const vec3_t bodymaxs, int bodysupercontents, matrix4x4_t *matrix, matrix4x4_t *inversematrix, const vec3_t start, int hitsupercontentsmask);
158 // like above but does not do a transform and does nothing if model is NULL
159 void Collision_ClipToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t mins, const vec3_t maxs, const vec3_t end, int hitsupercontents, float extend);
160 void Collision_ClipLineToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t end, int hitsupercontents, float extend, qboolean hitsurfaces);
161 void Collision_ClipPointToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, int hitsupercontents);
162 // caching surface trace for renderer (NOT THREAD SAFE)
163 void Collision_Cache_ClipLineToGenericEntitySurfaces(trace_t *trace, dp_model_t *model, matrix4x4_t *matrix, matrix4x4_t *inversematrix, const vec3_t start, const vec3_t end, int hitsupercontentsmask);
164 void Collision_Cache_ClipLineToWorldSurfaces(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t end, int hitsupercontents);
165 // combines data from two traces:
166 // merges contents flags, startsolid, allsolid, inwater
167 // updates fraction, endpos, plane and surface info if new fraction is shorter
168 void Collision_CombineTraces(trace_t *cliptrace, const trace_t *trace, void *touch, qboolean isbmodel);
169
170 // this enables rather large debugging spew!
171 // settings:
172 // 0 = no spew
173 // 1 = spew trace calls if something odd is happening
174 // 2 = spew trace calls always
175 // 3 = spew detailed trace flow (bsp tree recursion info)
176 #define COLLISIONPARANOID 0
177
178 extern cvar_t collision_impactnudge;
179 extern cvar_t collision_extendtracelinelength;
180 extern cvar_t collision_extendtraceboxlength;
181 extern cvar_t collision_extendmovelength;
182
183 #endif