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         // (1.0 = did not hit anything)
  31         double fraction;
  32         // like fraction but is not nudged away from the surface (better for
  33         // comparisons between two trace structs, as only one nudge for the final
  34         // result is ever needed)
  35         double realfraction;
  36         // final position of the trace (simply a point between start and end)
  37         double endpos[3];
  38         // surface normal at impact (not really correct for edge collisions)
  39         plane_t plane;
  40         // entity the surface is on
  41         // (not set by trace functions, only by physics)
  42         void *ent;
  43         // which SUPERCONTENTS bits to collide with, I.E. to consider solid
  44         // (this also affects startsolid/allsolid)
  45         int hitsupercontentsmask;
  46         // the supercontents mask at the start point
  47         int startsupercontents;
  48         // the supercontents of the impacted surface
  49         int hitsupercontents;
  50         // the q3 surfaceflags of the impacted surface
  51         int hitq3surfaceflags;
  52         // the texture of the impacted surface
  53         const struct texture_s *hittexture;
  54         // initially false, set when the start leaf is found
  55         // (set only by Q1BSP tracing and entity box tracing)
  56         int startfound;
  57         // if startsolid, contains the minimum penetration depth found in the
  58         // trace, and the normal needed to push it out of that solid
  59         double startdepth;
  60         double startdepthnormal[3];
  61 }
  62 trace_t;
  63
  64 void Collision_Init(void);
  65 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);
  66 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);
  67
  68 void Collision_Cache_Reset(qboolean resetlimits);
  69 void Collision_Cache_Init(mempool_t *mempool);
  70 void Collision_Cache_NewFrame(void);
  71
  72 typedef struct colpointf_s
  73 {
  74         vec3_t v;
  75 }
  76 colpointf_t;
  77
  78 typedef struct colplanef_s
  79 {
  80         const struct texture_s *texture;
  81         int q3surfaceflags;
  82         vec3_t normal;
  83         vec_t dist;
  84 }
  85 colplanef_t;
  86
  87 typedef struct colbrushf_s
  88 {
  89         // culling box
  90         vec3_t mins;
  91         vec3_t maxs;
  92         // used to avoid tracing against the same brush more than once per sweep
  93         int markframe;
  94         // the content flags of this brush
  95         int supercontents;
  96         // bounding planes (face planes) of this brush
  97         int numplanes;
  98         colplanef_t *planes;
  99         // edge directions (normals) of this brush
 100         int numedgedirs;
 101         colpointf_t *edgedirs;
 102         // points (corners) of this brush
 103         int numpoints;
 104         colpointf_t *points;
 105         // renderable triangles representing this brush, using the points
 106         int numtriangles;
 107         int *elements;
 108         // texture data for cases where an edgedir is used
 109         const struct texture_s *texture;
 110         int q3surfaceflags;
 111         // optimized collisions for common cases
 112         int isaabb; // indicates this is an axis aligned box
 113         int hasaabbplanes; // indicates this has precomputed planes for AABB collisions
 114 }
 115 colbrushf_t;
 116
 117 typedef struct colboxbrushf_s
 118 {
 119         colpointf_t points[8];
 120         colpointf_t edgedirs[6];
 121         colplanef_t planes[6];
 122         colbrushf_t brush;
 123 }
 124 colboxbrushf_t;
 125
 126 void Collision_CalcPlanesForTriangleBrushFloat(colbrushf_t *brush);
 127 colbrushf_t *Collision_AllocBrushFromPermanentPolygonFloat(mempool_t *mempool, int numpoints, float *points, int supercontents, int q3surfaceflags, const texture_t *texture);
 128 colbrushf_t *Collision_NewBrushFromPlanes(mempool_t *mempool, int numoriginalplanes, const colplanef_t *originalplanes, int supercontents, int q3surfaceflags, const texture_t *texture, int hasaabbplanes);
 129 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);
 130 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);
 131 void Collision_TraceLineBrushFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, const colbrushf_t *thatbrush_start, const colbrushf_t *thatbrush_end);
 132 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);
 133 void Collision_TracePointBrushFloat(trace_t *trace, const vec3_t point, const colbrushf_t *thatbrush);
 134 qboolean Collision_PointInsideBrushFloat(const vec3_t point, const colbrushf_t *brush);
 135
 136 void Collision_BrushForBox(colboxbrushf_t *boxbrush, const vec3_t mins, const vec3_t maxs, int supercontents, int q3surfaceflags, const texture_t *texture);
 137
 138 void Collision_BoundingBoxOfBrushTraceSegment(const colbrushf_t *start, const colbrushf_t *end, vec3_t mins, vec3_t maxs, float startfrac, float endfrac);
 139
 140 float Collision_ClipTrace_Line_Sphere(double *linestart, double *lineend, double *sphereorigin, double sphereradius, double *impactpoint, double *impactnormal);
 141 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);
 142 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);
 143
 144 // traces a box move against a single entity
 145 // mins and maxs are relative
 146 //
 147 // if the entire move stays in a single solid brush, trace.allsolid will be set
 148 //
 149 // if the starting point is in a solid, it will be allowed to move out to an
 150 // open area, and trace.startsolid will be set
 151 //
 152 // type is one of the MOVE_ values such as MOVE_NOMONSTERS which skips box
 153 // entities, only colliding with SOLID_BSP entities (doors, lifts)
 154 //
 155 // passedict is excluded from clipping checks
 156 struct frameblend_s;
 157 struct skeleton_s;
 158 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);
 159 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, qboolean hitsurfaces);
 160 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);
 161 // like above but does not do a transform and does nothing if model is NULL
 162 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);
 163 void Collision_ClipLineToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t end, int hitsupercontents, qboolean hitsurfaces);
 164 void Collision_ClipPointToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, int hitsupercontents);
 165 // caching surface trace for renderer (NOT THREAD SAFE)
 166 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);
 167 void Collision_Cache_ClipLineToWorldSurfaces(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t end, int hitsupercontents);
 168 // combines data from two traces:
 169 // merges contents flags, startsolid, allsolid, inwater
 170 // updates fraction, endpos, plane and surface info if new fraction is shorter
 171 void Collision_CombineTraces(trace_t *cliptrace, const trace_t *trace, void *touch, qboolean isbmodel);
 172
 173 // shorten a trace by the given factor
 174 void Collision_ShortenTrace(trace_t *trace, float shorten_factor, const vec3_t end);
 175
 176 // this enables rather large debugging spew!
 177 // settings:
 178 // 0 = no spew
 179 // 1 = spew trace calls if something odd is happening
 180 // 2 = spew trace calls always
 181 // 3 = spew detailed trace flow (bsp tree recursion info)
 182 #define COLLISIONPARANOID 0
 183
 184 // make every trace <collision_endposnudge>qu longer, and shorten the result, to work around a stupid bug somewhere
 185 #define COLLISION_STUPID_TRACE_ENDPOS_IN_SOLID_WORKAROUND
 186 #ifdef COLLISION_STUPID_TRACE_ENDPOS_IN_SOLID_WORKAROUND
 187 extern cvar_t collision_endposnudge;
 188 #endif
 189
 190
 191 #endif