Garry's Mod Wiki

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>