Revision Difference
ents.FindInBox#562112
<function name="FindInBox" parent="ents" type="libraryfunc">
<description>
Returns all entities within the specified box.
⤶
<note>This internally uses a Spatial Partition to avoid looping through all entities.</note>⤶
<note>Clientside entities will not be returned by this function. Serverside only entities without networked edicts(ent indexes), such as point logic or Constraints are not returned either</note>
⤶
This internally uses a Spatial Partition to avoid looping through all entities, so it is more efficient than using <page>ents.GetAll</page> for this purpose.⤶
<note>Clientside entities will not be returned by this function. Serverside only entities without networked edicts (entity indexes), such as point logic or Constraints are not returned either</note>
</description>
<realm>Shared</realm>
<args>
<arg name="boxMins" type="Vector">The box minimum coordinates.</arg>
<arg name="boxMaxs" type="Vector">The box maximum coordinates.</arg>
</args>
<rets>
<ret name="" type="table">A table of all found entities.</ret>
</rets>
</function>
<example>
<description>Returns a table of players in a box using ents.FindInBox</description>
<code>
function ents.FindPlayersInBox( vCorner1, vCorner2 )
local tEntities = ents.FindInBox( vCorner1, vCorner2 )
local tPlayers = {}
local iPlayers = 0
for i = 1, #tEntities do
if ( tEntities[ i ]:IsPlayer() ) then
iPlayers = iPlayers + 1
tPlayers[ iPlayers ] = tEntities[ i ]
end
end
return tPlayers, iPlayers
end
</code>
</example>