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