GitHub/amxmodx
2
0
Fork 0
mirror of https://github.com/alliedmodders/amxmodx.git synced 2024-12-26 06:45:37 +03:00
Code Issues Projects Releases Wiki Activity

Engine: Clarify difference between the engine module trace handle and the "real" global trace

Browse Source
This commit is contained in:
Valentin Grünbacher 2015-05-11 00:10:25 +02:00
parent ebdd015aae
commit ee0bcc39f1
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
plugins/include/engine.inc
View File

@ -25,7 +25,7 @@
#endif
/**
* Retrieves a result from the global trace handle.
* Retrieves a result from the global engine module trace handle.
*
* @note For a list of trace results available see the TR_* constants in
* engine_const.inc.
@ -964,8 +964,8 @@ native is_visible(entity, target);
* Fires a trace line between two origins, retrieving the end point and entity
* hit.
*
* @note This native writes to the global trace handle. Additional trace results
* can be retrieved using traceresult().
* @note This native writes to the global engine module trace handle. Additional
* trace results can be retrieved using traceresult().
* @note This native returns 0 if the trace did not hit anything. As 0 is an
* entity index that is considered to be a valid value for a trace hit
* ("worldspawn"), this native can potentially return a misleading value.
@ -984,8 +984,8 @@ native trace_line(iIgnoreEnt, const Float:fStart[3], const Float:fEnd[3], Float:
/**
* Fires a trace line between two origins, retrieving the trace normal.
*
* @note This native writes to the global trace handle. Additional trace results
* can be retrieved using traceresult().
* @note This native writes to the global engine module trace handle. Additional
* trace results can be retrieved using traceresult().
*
* @param iIgnoreEnt Entity index that trace will ignore, -1 if trace should
* not ignore any entities
@ -1001,8 +1001,8 @@ native trace_normal(iIgnoreEnt, const Float:fStart[3], const Float:fEnd[3], Floa
/**
* Fires a trace hull on a specified origin or between two origins.
*
* @note This native writes to the global trace handle. Additional trace results
* can be retrieved using traceresult().
* @note This native writes to the global engine module trace handle. Additional
* trace results can be retrieved using traceresult().
* @note For a list of valid hull types see the HULL_* constants in
* hlsdk_const.inc
* @note For a list of valid ignore types see the *IGNORE_* constants in
@ -1024,7 +1024,8 @@ native trace_hull(const Float:origin[3], hull, ignoredent = 0, ignoremonsters =
* direction, offset on the z-axis around an origin.
*
* @note The functionality of this native can mostly be replaced by a single
* hull trace. This native does not write to the global trace handle.
* hull trace. This native does not write to the global engine module
* trace handle.
* @note This native is intended to examine an obstacle in front of a standing
* player. Start should usually be the origin of a client while angle
* should be its forward angle vector. 73 traces are fired, each offset by