13 typedef struct trace_s
15 // if true, the entire trace was in solid (see hitsupercontentsmask)
17 // if true, the initial point was in solid (see hitsupercontentsmask)
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
21 // if true, the trace passed through empty somewhere
22 // (set only by Q1BSP tracing)
24 // if true, the trace passed through water/slime/lava somewhere
25 // (set only by Q1BSP tracing)
27 // fraction of the total distance that was traveled before impact
28 // (1.0 = did not hit anything)
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)
34 // final position of the trace (simply a point between start and end)
36 // surface normal at impact (not really correct for edge collisions)
38 // entity the surface is on
39 // (not set by trace functions, only by physics)
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
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)
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 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, texture_t *boxtexture);
62 typedef struct colpointf_s
68 typedef struct colplanef_s
70 struct texture_s *texture;
77 typedef struct colbrushf_s
79 // the content flags of this brush
81 // the number of bounding planes on this brush
83 // the number of corner points on this brush
85 // the number of renderable triangles on this brush
87 // array of bounding planes on this brush
89 // array of corner points on this brush
91 // renderable triangles, as int[3] elements indexing the points
93 // used to avoid tracing against the same brush more than once
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, int supercontents);
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 stride, float *bbox6f, 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 stride, float *bbox6f, 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 qboolean Collision_PointInsideBrushFloat(const vec3_t point, const colbrushf_t *brush);
113 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);
115 colbrushf_t *Collision_BrushForBox(const matrix4x4_t *matrix, const vec3_t mins, const vec3_t maxs, int supercontents, int q3surfaceflags, texture_t *texture);
117 void Collision_BoundingBoxOfBrushTraceSegment(const colbrushf_t *start, const colbrushf_t *end, vec3_t mins, vec3_t maxs, float startfrac, float endfrac);
119 float Collision_ClipTrace_Line_Sphere(double *linestart, double *lineend, double *sphereorigin, double sphereradius, double *impactpoint, double *impactnormal);
120 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);
122 // traces a box move against a single entity
123 // mins and maxs are relative
125 // if the entire move stays in a single solid brush, trace.allsolid will be set
127 // if the starting point is in a solid, it will be allowed to move out to an
128 // open area, and trace.startsolid will be set
130 // type is one of the MOVE_ values such as MOVE_NOMONSTERS which skips box
131 // entities, only colliding with SOLID_BSP entities (doors, lifts)
133 // passedict is excluded from clipping checks
134 void Collision_ClipToGenericEntity(trace_t *trace, dp_model_t *model, int frame, 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);
135 void Collision_ClipLineToGenericEntity(trace_t *trace, dp_model_t *model, int frame, 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);
136 void Collision_ClipPointToGenericEntity(trace_t *trace, dp_model_t *model, int frame, const vec3_t bodymins, const vec3_t bodymaxs, int bodysupercontents, matrix4x4_t *matrix, matrix4x4_t *inversematrix, const vec3_t start, int hitsupercontentsmask);
137 // like above but does not do a transform and does nothing if model is NULL
138 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);
139 void Collision_ClipLineToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, const vec3_t end, int hitsupercontents);
140 void Collision_ClipPointToWorld(trace_t *trace, dp_model_t *model, const vec3_t start, int hitsupercontents);
141 // combines data from two traces:
142 // merges contents flags, startsolid, allsolid, inwater
143 // updates fraction, endpos, plane and surface info if new fraction is shorter
144 void Collision_CombineTraces(trace_t *cliptrace, const trace_t *trace, void *touch, qboolean isbmodel);
146 // shorten a trace by the given factor
147 void Collision_ShortenTrace(trace_t *trace, float shorten_factor, const vec3_t end);
149 // this enables rather large debugging spew!
152 // 1 = spew trace calls if something odd is happening
153 // 2 = spew trace calls always
154 // 3 = spew detailed trace flow (bsp tree recursion info)
155 #define COLLISIONPARANOID 0
157 // make every trace 1qu longer, and shorten the result, to work around a stupid bug somewhere
158 #define COLLISION_STUPID_TRACE_ENDPOS_IN_SOLID_WORKAROUND