<function name="FindInCone" parent="ents" type="libraryfunc"> <description> Finds and returns all entities within the specified cone. Only entities whose <page>Entity:WorldSpaceCenter</page> is within the cone are considered to be in it. The "cone" is actually a conical "slice" of an axis-aligned box (see: <page>ents.FindInBox</page>). The image to the right shows approximately how this function would look in 2D. Due to this, the entity may be farther than the specified range! <image src="ents.FindInCone.png" alt="2D_visualization_of_the_actual_shape_of_the_cone,_click_to_enlarge"/> <note>Clientside entities will not be returned by this function.</note> </description> <realm>Shared</realm> <args> <arg name="origin" type="Vector">The tip of the cone.</arg> <arg name="normal" type="Vector">Direction of the cone.</arg> <arg name="range" type="number">The range of the cone/box around the origin. <note> The function internally adds 1 to this argument before using it. </note> </arg> <arg name="angle_cos" type="number">The <page text="cosine">math.cos</page> of the angle between the center of the cone to its edges, which is half the overall angle of the cone. 1 makes a 0° cone, 0.707 makes approximately 90°, 0 makes 180°, and so on.</arg> </args> <rets> <ret name="" type="table<Entity>">A table of all found <page>Entity</page>s.</ret> </rets> </function> <example> <description>An example usage of this function. This example shows which entities are being returned by the function with red lines and the range with white transparent box.</description> <description>Demonstrates how this function works.</description> <code> local mat = Material( "models/shiny" )⤶ mat:SetFloat( "$alpha", 0.5 )⤶ ⤶ hook.Add( "PostDrawOpaqueRenderables", "conetest", function()⤶ local size = 200⤶ local dir = LocalPlayer():GetAimVector() local angle = math.cos( math.rad( 15 ) ) -- 15 degrees⤶ local startPos = LocalPlayer():EyePos() ⤶ local entities = ents.FindInCone( startPos, dir, size, angle )⤶ -- draw the outer box⤶ local mins = Vector( -size, -size, -size ) local maxs = Vector( size, size, size ) render.SetMaterial( mat ) render.DrawWireframeBox( startPos, Angle( 0, 0, 0 ), mins, maxs, color_white, true )⤶ render.DrawBox( startPos, Angle( 0, 0, 0 ), -mins, -maxs, color_white )⤶ -- draw the lines⤶ for id, ent in ipairs( entities ) do⤶ render.DrawLine( ent:WorldSpaceCenter() - dir * ( ent:WorldSpaceCenter()-startPos ):Length(), ent:WorldSpaceCenter(), Color( 255, 0, 0 ) ) local size = 128⤶ local fov = 15⤶ local segments = 32⤶ ⤶ local mat = Material("models/shiny")⤶ mat:SetFloat("$alpha", 0.25) ⤶ hook.Add("PostDrawOpaqueRenderables", "ents.FindInCone demo", function()⤶ local ply = LocalPlayer() if IsValid(ply) == false then return end⤶ local startPos = ply:EyePos()⤶ ⤶ local dir = ply:GetAimVector() dir:Normalize() local angleCos = math.cos(math.rad(fov)) local radius = math.tan(math.acos(angleCos)) * size⤶ local endPos = startPos + dir * size⤶ render.SetMaterial(mat)⤶ render.DrawSphere(startPos, size, 24, 16, color_white, true)⤶ ⤶ local up = Vector(0, 0, 1) if math.abs(dir:Dot(up)) > 0.99 then⤶ up = Vector(1, 0, 0)⤶ end⤶ ⤶ local right = dir:Cross(up)⤶ right:Normalize()⤶ ⤶ up = right:Cross(dir)⤶ up:Normalize()⤶ ⤶ render.SetColorMaterial()⤶ ⤶ for i = 0, segments - 1 do⤶ local a1 = (i / segments) * math.pi * 2⤶ local a2 = ((i + 1) / segments) * math.pi * 2⤶ ⤶ local p1 = endPos + (right * math.cos(a1) + up * math.sin(a1)) * radius⤶ local p2 = endPos + (right * math.cos(a2) + up * math.sin(a2)) * radius⤶ ⤶ render.DrawBeam(p1, p2, 2, 0, 1, Color(17, 163, 204, 50))⤶ render.DrawBeam(startPos, p1, 2, 0, 1, Color(0, 124, 158, 50))⤶ end⤶ ⤶ render.DrawLine(startPos, endPos, Color(0, 255, 0), true)⤶ ⤶ for _, ent in ipairs(ents.FindInCone(startPos, dir, size, angleCos)) do⤶ render.DrawLine(⤶ startPos,⤶ ent:WorldSpaceCenter(),⤶ Color(255, 0, 0),⤶ true⤶ )⤶ end end ) end) </code> <output>⤶ <image src="https://i.imgur.com/ro85Z4a.gif" alt="ents.FindInCone demonstration" />⤶ </output>⤶ </example>