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 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
  20         int bmodelstartsolid;
  21         // if true, the trace passed through empty somewhere
  22         // (set only by Q1BSP tracing)
  23         int inopen;
  24         // if true, the trace passed through water/slime/lava somewhere
  25         // (set only by Q1BSP tracing)
  26         int inwater;
  27         // fraction of the total distance that was traveled before impact
  28         // (1.0 = did not hit anything)
  29         double fraction;
  30         // like fraction but is not nudged away from the surface (better for
  31         // comparisons between two trace structs, as only one nudge for the final
  32         // result is ever needed)
  33         double realfraction;
  34         // final position of the trace (simply a point between start and end)
  35         double endpos[3];
  36         // surface normal at impact (not really correct for edge collisions)
  37         plane_t plane;
  38         // entity the surface is on
  39         // (not set by trace functions, only by physics)
  40         void *ent;
  41         // which SUPERCONTENTS bits to collide with, I.E. to consider solid
  42         // (this also affects startsolid/allsolid)
  43         int hitsupercontentsmask;
  44         // the supercontents mask at the start point
  45         int startsupercontents;
  46         // the supercontents of the impacted surface
  47         int hitsupercontents;
  48         // the q3 surfaceflags of the impacted surface
  49         int hitq3surfaceflags;
  50         // the texture of the impacted surface
  51         struct texture_s *hittexture;
  52         // initially false, set when the start leaf is found
  53         // (set only by Q1BSP tracing and entity box tracing)
  54         int startfound;
  55 }
  56 trace_t;
  57
  58 void Collision_Init(void);
  59 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, texture_t *boxtexture);
  60
  61 typedef struct colpointf_s
  62 {
  63         float v[3];
  64 }
  65 colpointf_t;
  66
  67 typedef struct colplanef_s
  68 {
  69         float normal[3];
  70         float dist;
  71         int supercontents;
  72         int q3surfaceflags;
  73         struct texture_s *texture;
  74 }
  75 colplanef_t;
  76
  77 typedef struct colbrushf_s
  78 {
  79         // the content flags of this brush
  80         int supercontents;
  81         // the number of bounding planes on this brush
  82         int numplanes;
  83         // the number of corner points on this brush
  84         int numpoints;
  85         // the number of renderable triangles on this brush
  86         int numtriangles;
  87         // array of bounding planes on this brush
  88         colplanef_t *planes;
  89         // array of corner points on this brush
  90         colpointf_t *points;
  91         // renderable triangles, as int[3] elements indexing the points
  92         int *elements;
  93         // used to avoid tracing against the same brush more than once
  94         int markframe;
  95         // culling box
  96         vec3_t mins;
  97         vec3_t maxs;
  98 }
  99 colbrushf_t;
 100
 101 void Collision_CalcPlanesForPolygonBrushFloat(colbrushf_t *brush);
 102 colbrushf_t *Collision_AllocBrushFromPermanentPolygonFloat(mempool_t *mempool, int numpoints, float *points, int supercontents);
 103 colbrushf_t *Collision_NewBrushFromPlanes(mempool_t *mempool, int numoriginalplanes, const colplanef_t *originalplanes);
 104 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);
 105 void Collision_TraceBrushPolygonFloat(trace_t *trace, const colbrushf_t *thisbrush_start, const colbrushf_t *thisbrush_end, int numpoints, const float *points, int supercontents);
 106 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 supercontents, int q3surfaceflags, texture_t *texture, const vec3_t segmentmins, const vec3_t segmentmaxs);
 107 void Collision_TraceLineBrushFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, const colbrushf_t *thatbrush_start, const colbrushf_t *thatbrush_end);
 108 void Collision_TraceLinePolygonFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, int numpoints, const float *points, int supercontents);
 109 void Collision_TraceLineTriangleMeshFloat(trace_t *trace, const vec3_t linestart, const vec3_t lineend, int numtriangles, const int *element3i, const float *vertex3f, int supercontents, int q3surfaceflags, texture_t *texture, const vec3_t segmentmins, const vec3_t segmentmaxs);
 110 void Collision_TracePointBrushFloat(trace_t *trace, const vec3_t point, const colbrushf_t *thatbrush);
 111
 112 void Collision_TraceBrushPolygonTransformFloat(trace_t *trace, const colbrushf_t *thisbrush_start, const colbrushf_t *thisbrush_end, int numpoints, const float *points, const matrix4x4_t *polygonmatrixstart, const matrix4x4_t *polygonmatrixend, int supercontents, int q3surfaceflags, texture_t *texture);
 113
 114 colbrushf_t *Collision_BrushForBox(const matrix4x4_t *matrix, const vec3_t mins, const vec3_t maxs, int supercontents, int q3surfaceflags, texture_t *texture);
 115
 116 void Collision_BoundingBoxOfBrushTraceSegment(const colbrushf_t *start, const colbrushf_t *end, vec3_t mins, vec3_t maxs, float startfrac, float endfrac);
 117
 118 float Collision_ClipTrace_Line_Sphere(double *linestart, double *lineend, double *sphereorigin, double sphereradius, double *impactpoint, double *impactnormal);
 119 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, texture_t *texture);
 120
 121 // this enables rather large debugging spew!
 122 // settings:
 123 // 0 = no spew
 124 // 1 = spew trace calls if something odd is happening
 125 // 2 = spew trace calls always
 126 // 3 = spew detailed trace flow (bsp tree recursion info)
 127 #define COLLISIONPARANOID 0
 128
 129 #endif