Tracing - Revision history

Outerbeast: /* Trace methods */

2026-01-30T15:48:04Z

Trace methods

← Older revision		Revision as of 17:48, 30 January 2026
Line 91:		Line 91:
	\| Uses point based bounds (zeroed out mins and maxs)		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-
			\| <code>TraceResult GetGlobalTrace()<code>
			\| style="vertical-align:middle;" \| Gets the global trace data stored in g_Engine as a TraceResult object.<br/>Results from entity Touch methods are obtained from this
			\|
	\|}		\|}

Outerbeast: /* Trace methods */

2025-06-11T12:45:39Z

Trace methods

← Older revision		Revision as of 14:45, 11 June 2025
Line 89:		Line 89:
	\| <code>void TankTrace(const Vector& in vecStart, const Vector& in vecForward, const Vector& in vecSpread, TraceResult& out tr)</code>		\| <code>void TankTrace(const Vector& in vecStart, const Vector& in vecForward, const Vector& in vecSpread, TraceResult& out tr)</code>
	\| style="vertical-align:middle;" \| Performs a traceline using a random spread based on the given spread amount.<br>This is a CBaseTank method.		\| style="vertical-align:middle;" \| Performs a traceline using a random spread based on the given spread amount.<br>This is a CBaseTank method.
	\| ~~The~~ bounds ~~are relative to the input traceline's endpoint.~~		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-
	\|}		\|}

Outerbeast: /* Trace methods */

2025-06-11T12:42:09Z

Trace methods

← Older revision		Revision as of 14:42, 11 June 2025
Line 45:		Line 45:
	<code>CUtility g_Utility;</code>		<code>CUtility g_Utility;</code>

	Note: The method <code>~~TraceTank~~</code> belongs to the CBaseTank class.		Note: The method <code>TankTrace</code> belongs to the CBaseTank class.

	There are a number of traces that can be performed:		There are a number of traces that can be performed:

Outerbeast: /* Trace methods */

2025-06-11T12:41:48Z

Trace methods

← Older revision		Revision as of 14:41, 11 June 2025
Line 45:		Line 45:
	<code>CUtility g_Utility;</code>		<code>CUtility g_Utility;</code>

	Note: The method <code>TraceTank<code> belongs to the CBaseTank class.		Note: The method <code>TraceTank</code> belongs to the CBaseTank class.

	There are a number of traces that can be performed:		There are a number of traces that can be performed:

Outerbeast at 12:41, 11 June 2025

2025-06-11T12:41:36Z

← Older revision		Revision as of 14:41, 11 June 2025
Line 42:		Line 42:
	== Trace methods ==		== Trace methods ==
	Supported trace operations are listed below and are accessible via the [[CUtility#Tracing_methods\|CUtility]] class.		Supported trace operations are listed below and are accessible via the [[CUtility#Tracing_methods\|CUtility]] class.

	A global instance exists:		A global instance exists:
	<code>CUtility g_Utility;</code>		<code>CUtility g_Utility;</code>

			Note: The method <code>TraceTank<code> belongs to the CBaseTank class.

	There are a number of traces that can be performed:		There are a number of traces that can be performed:
Line 84:		Line 85:
	\| <code>void FindHullIntersection(const Vector& in vecSrc, TraceResult& in inTr, TraceResult& out outTr, const Vector& in vecMins, const Vector& in vecMaxs, edict_t@ pEntity, float flDistance = 1e6f)</code>		\| <code>void FindHullIntersection(const Vector& in vecSrc, TraceResult& in inTr, TraceResult& out outTr, const Vector& in vecMins, const Vector& in vecMaxs, edict_t@ pEntity, float flDistance = 1e6f)</code>
	\| style="vertical-align:middle;" \| Finds the hull intersection from a traceline in a given set of bounds.<br />The given entity is the entity performing the traceline.		\| style="vertical-align:middle;" \| Finds the hull intersection from a traceline in a given set of bounds.<br />The given entity is the entity performing the traceline.
			\| The bounds are relative to the input traceline's endpoint.
			\|-
			\| <code>void TankTrace(const Vector& in vecStart, const Vector& in vecForward, const Vector& in vecSpread, TraceResult& out tr)</code>
			\| style="vertical-align:middle;" \| Performs a traceline using a random spread based on the given spread amount.<br>This is a CBaseTank method.
	\| The bounds are relative to the input traceline's endpoint.		\| The bounds are relative to the input traceline's endpoint.
	\|-		\|-

Outerbeast: /* IGNORE_MONSTERS */

2025-02-20T03:58:46Z

IGNORE_MONSTERS

← Older revision		Revision as of 05:58, 20 February 2025
Line 93:		Line 93:
	\|- style="font-weight:bold; text-align:center;"		\|- style="font-weight:bold; text-align:center;"
	! Constant		! Constant
	! ~~Hull #~~		! Purpose
	~~! Default Mins~~
	~~! Default Maxs~~
	~~! Default Size~~
	\|-		\|-
	\| ~~point_hull~~		\| dont_ignore_monsters
	\| 0		\| Don't ignore monsters.
	~~\| 0, 0, 0~~
	~~\| 0, 0, 0~~
	~~\| 0x0x0~~
	\|-		\|-
	\| ~~human_hull~~		\| ignore_monsters
	\| 1		\| Ignore monsters.
	~~\| -16, -16, -36~~
	~~\| 16, 16, 36~~
	~~\| 32x32x72~~
	\|-		\|-
	\| ~~large_hull~~		\| missile
	~~\| 2~~		\| The trace bounds are set to mins -15, -15, -15 and maxs 15, 15, 15. Otherwise, the bounds are specified by the traceline operation.
	\| -32, -32, -32
	~~\| 32~~, 32, 32
	~~\| 64x64x64~~
	\|-
	~~\| head_hull~~
	~~\| 3~~
	~~\| -16, -16, -18~~
	~~\| 16, 16~~, 18
	~~\| 32x32x36~~
	\|}		\|}

Outerbeast: /* Trace methods */

2025-02-20T03:54:23Z

Trace methods

← Older revision		Revision as of 05:54, 20 February 2025
Line 55:		Line 55:
	\|-		\|-
	\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntIgnore, TraceResult& out ptr)</code>		\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntIgnore, TraceResult& out ptr)</code>
	\| Calculates a trace along the given line, storing the results in ptr. If igmon is ignore_monsters, entities with a solid setting other than SOLID_BSP and a movetype other than MOVETYPE_PUSHSTEP (pushables) are ignored. If pEntIgnore is set, the entity will not be considered in traceline calculations.		\| Calculates a trace along the given line, storing the results in ptr. If <code>igmon</code> is ignore_monsters, entities with a solid setting other than SOLID_BSP and a movetype other than MOVETYPE_PUSHSTEP (pushables) are ignored. If <code>pEntIgnore</code> is set, the entity will not be considered in traceline calculations.
	\| Uses point based bounds (zeroed out mins and maxs)		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-
	\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, IGNORE_GLASS ignoreGlass, edict_t@ pEntIgnore, TraceResult& out ptr)</code>		\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, IGNORE_GLASS ignoreGlass, edict_t@ pEntIgnore, TraceResult& out ptr)</code>
	\| Same as the above function, but also allows you to specify whether or not to ignore glass. If ignore_glass is specified, brush entities with a render mode other than normal and that don't have the FL_WORLDBRUSH flag set are ignored.		\| Same as the above function, but also allows you to specify whether or not to ignore glass. If ignore_glass is specified, brush entities with a render mode other than normal and that don't have the <code>FL_WORLDBRUSH</code> flag set are ignored.
	\| Uses point based bounds (zeroed out mins and maxs)		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-

Outerbeast: /* TraceResult */

2025-02-15T01:07:44Z

TraceResult

← Older revision		Revision as of 03:07, 15 February 2025
Line 2:		Line 2:

	== TraceResult ==		== TraceResult ==
	The <code>TraceResult</code> class stores trace results that are performed by trace methods. Passing in a TraceResult object into a given trace method will modify the object, and so the results from the trace method can be accessed. Not all trace operations require the use of a <code>TraceResult ~~object.~~</code>		The <code>TraceResult</code> class stores trace results that are performed by trace methods. Passing in a TraceResult object into a given trace method will modify the object, and so the results from the trace method can be accessed. Not all trace operations require the use of a <code>TraceResult</code> object.

	{\| class="wikitable" style="vertical-align:middle;"		{\| class="wikitable" style="vertical-align:middle;"

Outerbeast at 01:06, 15 February 2025

2025-02-15T01:06:57Z

← Older revision		Revision as of 03:06, 15 February 2025
Line 2:		Line 2:

	== TraceResult ==		== TraceResult ==
	The TraceResult class stores trace results. Not all trace operations require the use of a TraceResult object.		The <code>TraceResult</code> class stores trace results that are performed by trace methods. Passing in a TraceResult object into a given trace method will modify the object, and so the results from the trace method can be accessed. Not all trace operations require the use of a <code>TraceResult object.</code>

	{\| class="wikitable" style="vertical-align:middle;"		{\| class="wikitable" style="vertical-align:middle;"

Outerbeast at 17:40, 14 February 2025

2025-02-14T17:40:44Z

← Older revision		Revision as of 19:40, 14 February 2025
Line 9:		Line 9:
	! Description		! Description
	\|-		\|-
	\| int fAllSolid		\| <code>int fAllSolid
	\| Flag telling whether the trace started and ended in a solid area. If true, the plane is not valid.		\| Flag telling whether the trace started and ended in a solid area. If true, the plane is not valid.
	\|-		\|-
	\| int fStartSolid		\| <code>int fStartSolid
	\| Flag telling whether the trace started in a solid area.		\| Flag telling whether the trace started in a solid area.
	\|-		\|-
	\| int fInOpen		\| <code>int fInOpen
	\| Flag telling whether the trace ended in empty space.		\| Flag telling whether the trace ended in empty space.
	\|-		\|-
	\| int fInWater		\| <code>int fInWater
	\| Flag telling whether the trace ended in water.		\| Flag telling whether the trace ended in water.
	\|-		\|-
	\| float flFraction		\| <code>float flFraction
	\| How much of the trace's total distance was covered. 1.0 means it didn't hit anything.		\| How much of the trace's total distance was covered. 1.0 means it didn't hit anything.
	\|-		\|-
	\| Vector vecEndPos		\| <code>Vector vecEndPos
	\| End position. If flFraction is 1.0, this is invalid.		\| End position. If flFraction is 1.0, this is invalid.
	\|-		\|-
	\| float flPlaneDist		\| <code>float flPlaneDist
	\| Brush plane distance. This appears to be the dot product between the first plane point and the normal. Its purpose is unknown, and there are no known uses. If flFraction is 1.0, this is invalid. If the hit object is not a brush, this is invalid.		\| Brush plane distance. This appears to be the dot product between the first plane point and the normal. Its purpose is unknown, and there are no known uses. If flFraction is 1.0, this is invalid. If the hit object is not a brush, this is invalid.
	\|-		\|-
	\| Vector vecPlaneNormal		\| <code>Vector vecPlaneNormal
	\| Brush plane normal. If flFraction is 1.0, this is invalid. If the hit object is not a brush, this is invalid.		\| Brush plane normal. If flFraction is 1.0, this is invalid. If the hit object is not a brush, this is invalid.
	\|-		\|-
	\| edict_t@ pHit		\| <code>edict_t@ pHit
	\| Hit entity. If flFraction is 1.0, this is null.		\| Hit entity. If flFraction is 1.0, this is null.
	\|-		\|-
	\| int iHitgroup		\| <code>int iHitgroup
	\| Studio model hit group. if flFraction is 1.0, this is invalid. If the hit object is not a studio model, this is invalid.		\| Studio model hit group. if flFraction is 1.0, this is invalid. If the hit object is not a studio model, this is invalid.
	\|}		\|}
Line 54:		Line 54:
	! Bounds		! Bounds
	\|-		\|-
	\| void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntIgnore, TraceResult& out ptr)		\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntIgnore, TraceResult& out ptr)</code>
	\| Calculates a trace along the given line, storing the results in ptr. If igmon is ignore_monsters, entities with a solid setting other than SOLID_BSP and a movetype other than MOVETYPE_PUSHSTEP (pushables) are ignored. If pEntIgnore is set, the entity will not be considered in traceline calculations.		\| Calculates a trace along the given line, storing the results in ptr. If igmon is ignore_monsters, entities with a solid setting other than SOLID_BSP and a movetype other than MOVETYPE_PUSHSTEP (pushables) are ignored. If pEntIgnore is set, the entity will not be considered in traceline calculations.
	\| Uses point based bounds (zeroed out mins and maxs)		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-
	\| void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, IGNORE_GLASS ignoreGlass, edict_t@ pEntIgnore, TraceResult& out ptr)		\| <code>void TraceLine(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, IGNORE_GLASS ignoreGlass, edict_t@ pEntIgnore, TraceResult& out ptr)</code>
	\| Same as the above function, but also allows you to specify whether or not to ignore glass. If ignore_glass is specified, brush entities with a render mode other than normal and that don't have the FL_WORLDBRUSH flag set are ignored.		\| Same as the above function, but also allows you to specify whether or not to ignore glass. If ignore_glass is specified, brush entities with a render mode other than normal and that don't have the FL_WORLDBRUSH flag set are ignored.
	\| Uses point based bounds (zeroed out mins and maxs)		\| Uses point based bounds (zeroed out mins and maxs)
	\|-		\|-
	\| void TraceHull(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, HULL_NUMBER hullNumber, edict_t@ pEntIgnore, TraceResult& out ptr)		\| <code>void TraceHull(const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, HULL_NUMBER hullNumber, edict_t@ pEntIgnore, TraceResult& out ptr)</code>
	\| Similar to TraceLine, but will use the specified hull's bounds instead of point based bounds.		\| Similar to TraceLine, but will use the specified hull's bounds instead of point based bounds.
	\| Uses the specified hull's bounds. Maps can specify these bounds in newer compilers, so avoid assuming a particular value is in use.		\| Uses the specified hull's bounds. Maps can specify these bounds in newer compilers, so avoid assuming a particular value is in use.
	\|-		\|-
	\| void TraceToss(edict_t@ pEntity, edict_t@ pEntityToIgnore, TraceResult& out traceResult)		\| <code>void TraceToss(edict_t@ pEntity, edict_t@ pEntityToIgnore, TraceResult& out traceResult)</code>
	\| Traces a toss. This simulates tossing the entity using its current origin, velocity, angular velocity, angles and gravity. Note that this does not use the same code as MOVETYPE_TOSS, and may return different results.		\| Traces a toss. This simulates tossing the entity using its current origin, velocity, angular velocity, angles and gravity. Note that this does not use the same code as MOVETYPE_TOSS, and may return different results.
	\| Uses the given entity's bounds.		\| Uses the given entity's bounds.
	\|-		\|-
	\| bool TraceMonsterHull(edict_t@ pEntity, const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntityToIgnore, TraceResult& out ptr)		\| <code>bool TraceMonsterHull(edict_t@ pEntity, const Vector& in vecStart, const Vector& in vecEnd, IGNORE_MONSTERS igmon, edict_t@ pEntityToIgnore, TraceResult& out ptr)</code>
	\| Performs a trace using the given entity's mins and maxs. This can be any entity, not just monsters. Returns true if the trace was entirely in a solid object, or if it hit something.		\| Performs a trace using the given entity's mins and maxs. This can be any entity, not just monsters. Returns true if the trace was entirely in a solid object, or if it hit something.
	\| Uses the given entity's bounds.		\| Uses the given entity's bounds.
	\|-		\|-
	\| void TraceModel(const Vector& in vecStart, const Vector& in vecEnd, int iHullNumber, edict_t@ pEntityToIgnore, TraceResult& out ptr)		\| <code>void TraceModel(const Vector& in vecStart, const Vector& in vecEnd, int iHullNumber, edict_t@ pEntityToIgnore, TraceResult& out ptr)</code>
	\| Similar to TraceHull, but will instead perform a trace in the given world hull using the given entity's model's hulls. For studio models this will use the model's hitboxes.		\| Similar to TraceHull, but will instead perform a trace in the given world hull using the given entity's model's hulls. For studio models this will use the model's hitboxes.
	\| If the given entity's model is a studio model, uses its hitboxes. If it's a brush model, the brush model's hull for the given hull number is used (this may differ if custom brush hull sizes are in use). Otherwise, the entity bounds are converted into a hull.		\| If the given entity's model is a studio model, uses its hitboxes. If it's a brush model, the brush model's hull for the given hull number is used (this may differ if custom brush hull sizes are in use). Otherwise, the entity bounds are converted into a hull.
	\|-		\|-
	\| string TraceTexture(edict_t@ pEntity, const Vector& in vecStart, const Vector& in vecEnd)		\| <code>string TraceTexture(edict_t@ pEntity, const Vector& in vecStart, const Vector& in vecEnd)</code>
	\| Used to get the name of a texture. The given entity must have a brush model set. If the traceline intersects the model, the name of the texture of the surface it intersected is returned. Otherwise, returns an empty string.		\| Used to get the name of a texture. The given entity must have a brush model set. If the traceline intersects the model, the name of the texture of the surface it intersected is returned. Otherwise, returns an empty string.
	\| Uses point based bounds (zeroed out mins and maxs). CUtility::GetGlobalTrace() can be used to obtain this trace.		\| Uses point based bounds (zeroed out mins and maxs). CUtility::GetGlobalTrace() can be used to obtain this trace.
	\|-		\|-
	\| void FindHullIntersection(const Vector& in vecSrc, TraceResult& in inTr, TraceResult& out outTr, const Vector& in vecMins, const Vector& in vecMaxs, edict_t@ pEntity, float flDistance = 1e6f)		\| <code>void FindHullIntersection(const Vector& in vecSrc, TraceResult& in inTr, TraceResult& out outTr, const Vector& in vecMins, const Vector& in vecMaxs, edict_t@ pEntity, float flDistance = 1e6f)</code>
	\| style="vertical-align:middle;" \| Finds the hull intersection from a traceline in a given set of bounds.<br />The given entity is the entity performing the traceline.		\| style="vertical-align:middle;" \| Finds the hull intersection from a traceline in a given set of bounds.<br />The given entity is the entity performing the traceline.
	\| The bounds are relative to the input traceline's endpoint.		\| The bounds are relative to the input traceline's endpoint.