Revision Difference
util.GetPlayerTrace#512326
<function name="GetPlayerTrace" parent="util" type="libraryfunc">⤶
<description>Utility function to quickly generate a trace table that starts at the players view position, and ends 16384 units along a specified direction.</description>⤶
<realm>Shared and Menu</realm>⤶
<file line="31-L48">lua/includes/extensions/util.lua</file>⤶
<args>⤶
<arg name="ply" type="Player">The player the trace should be based on</arg>⤶
<arg name="dir" type="Vector" default="ply:GetAimVector()">The direction of the trace</arg>⤶
</args>⤶
<rets>⤶
<ret name="" type="table">The trace data. See <page>Trace</page></ret>⤶
</rets>⤶
</function>⤶
⤶
<example>⤶
<description>Prints the entity's model the local player is looking at to console</description>⤶
<code>⤶
local tr = util.TraceLine( util.GetPlayerTrace( LocalPlayer() ) )⤶
if IsValid(tr.Entity) then print("I saw a "..tr.Entity:GetModel()) end⤶
⤶
local trground = util.TraceLine( util.GetPlayerTrace( LocalPlayer(), Vector(0,0,-1) ) )⤶
if IsValid(trground.Entity) then print("I'm standing on a "..trground.Entity:GetModel()) end⤶
</code>⤶
⤶
</example>