nearObjects: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| arma1 \|1.00 \|([^g]|g[^a])" to "| arma1 |1.00 |game2= arma2 |version2= 1.00 |game3= arma2oa |version3= 1.50 |game4= tkoh |version4= 1.00 |game5= arma3 |version5= 0.50 |$1")
m (Fixed (and slightly clarified) notes)
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1
|1.00
|version1= 1.00


|game2= arma2
|game2= arma2
Line 18: Line 18:
|gr1= Object Detection
|gr1= Object Detection


| Find objects (Units, Vehicles, Dead, Map Objects) in a sphere with given radius. The first object in the returned array is ''not'' necessarily the closest one. If you need returned objects to be sorted by distance, use [[nearestObjects]]. If typeName is given, only objects of given type (or its subtype) are listed.
|descr= Find objects (Units, Vehicles, Dead, Map Objects) in a sphere with given radius. The first object in the returned array is ''not'' necessarily the closest one. If you need returned objects to be sorted by distance, use [[nearestObjects]]. If typeName is given, only objects of given type (or its subtype) are listed.


| position [[nearObjects]] radius
|s1= position [[nearObjects]] radius


|p1= position: [[Position]], [[Position2D]] or [[Object]]
|p1= position: [[Position]], [[Position#Introduction|Position2D]] or [[Object]]


|p2= radius: [[Number]]
|p2= radius: [[Number]]
Line 30: Line 30:
|s2= position [[nearObjects]] [typeName, radius]
|s2= position [[nearObjects]] [typeName, radius]


|p21= position: [[PositionAGL]], [[Position2D]] or [[Object]]
|p21= position: [[Array]] format [[Position#PositionAGL|PositionAGL]], [[Position#Introduction|Position2D]] or [[Object]]


|p22= [typeName, radius]: [[Array]]
|p22= typeName: [[String]]


|p23= typeName: [[String]]
|p23= radius: [[Number]]
 
|p24= radius: [[Number]]


|r2= [[Array]]
|r2= [[Array]]


|x1= <code>_list = [[position]] [[player]] [[nearObjects]] 50;</code>
|x1= <sqf>_list = position player nearObjects 50;</sqf>


|x2= <code>_list = [_xpos,_ypos] [[nearObjects]] ["House", 20];</code>
|x2= <sqf>_list = [_xpos,_ypos] nearObjects ["House", 20];</sqf>


|x3= <code>_list = [[player]] [[nearObjects]] 20;</code>
|x3= <sqf>_list = player nearObjects 20;</sqf>


|seealso= [[findNearestEnemy]], [[nearestBuilding]], [[nearestObject]], [[nearestObjects]], [[nearestLocation]], [[nearEntities]], [[nearTargets]], [[nearSupplies]], [[nearestLocationWithDubbing]], [[nearObjectsReady]], [[nearRoads]]
|seealso= [[findNearestEnemy]] [[nearestBuilding]] [[nearestObject]] [[nearestObjects]] [[nearestLocation]] [[nearEntities]] [[nearTargets]] [[nearSupplies]] [[nearestLocationWithDubbing]] [[nearObjectsReady]] [[nearRoads]] [[nearestMines]]
}}
}}


<dl class="command_description">
{{Note
|user= Kronzky
|timestamp= 20070630082100
|text= Units in vehicles are not detected via this command.
}}


<dt></dt>
{{Note
<dd class="notedate">Posted on June 30, 2007 - 08:21</dd>
|user= Tankbuster
<dt class="note">[[User:Kronzky|Kronzky]]</dt>
|timestamp= 20111215231700
<dd class="note">
|text= In the second syntax, you can't omit the typeName parameter. It's required and you'll get an error if you don't supply it. Use "All" as an alternative to leaving it out. (CO 1.59)
Units in vehicles are not detected via this command.
}}
<dt><dt>
<dd class="notedate">Posted on December 15, 2011 - 23:17</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dd class="note">
In the second example, you can't omit the typeName parameter. It's required and you'll get an error if you don't supply it. Use "All" as an alternative to leaving it out. (CO 1.59)
<dt><dt>
<dd class="notedate">Posted on January 3, 2013 - 19:59</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dd class="note">
If you use the first example, it will return objects many more objects such as pollen, honeybees and crucially, triggers. Triggers will show in the returned array as "no shape" but you can use typeOf to get the classname, which will give "EmptyDetector". This will not return objects that don't have classnames such as plants, stones and some map objects like vehicle wrecks. nearestObjects will find objects without classnames.
</dl>


{{GameCategory|arma1|Scripting Commands}}
{{Note
{{GameCategory|arma2|Scripting Commands}}
|user= Tankbuster
{{GameCategory|arma3|Scripting Commands}}
|timestamp= 20130103195900
{{GameCategory|tkoh|Scripting Commands}}
|text= If you use the first syntax, it will return objects many more objects such as pollen, honeybees and crucially, triggers. Triggers will show in the returned array as "no shape" but you can use typeOf to get the classname, which will give "EmptyDetector". This will not return objects that don't have classnames such as plants, stones and some map objects like vehicle wrecks. nearestObjects will find objects without classnames.
}}


<dl class="command_description">
{{Note
 
|user= Cheitan
<dt></dt>
|timestamp= 20170808160800
<dd class="notedate">Posted on August 8, 2017 - 16:08 (UTC)</dd>
|text= The syntax 2 means that the command will include all types which inherit from the given type. As an example, when using "Helipad_Base_F", the command will detect all types of helipads (Land_HelipadSquare_F, Land_HelipadCircle_F, Land_HelipadEmpty_F, etc) in the given radius.
<dt class="note">[[User:Cheitan|Cheitan]]</dt>
}}
<dd class="note">
The example 2 means that the command will include all types which inherit from the given type. As an example, when using "Helipad_Base_F", the command will detect all types of helipads (Land_HelipadSquare_F, Land_HelipadCircle_F, Land_HelipadEmpty_F, etc) in the given radius.
</dd>
</dl>

Latest revision as of 20:27, 8 September 2022

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Find objects (Units, Vehicles, Dead, Map Objects) in a sphere with given radius. The first object in the returned array is not necessarily the closest one. If you need returned objects to be sorted by distance, use nearestObjects. If typeName is given, only objects of given type (or its subtype) are listed.
Groups:
Object Detection

Syntax

Syntax:
position nearObjects radius
Parameters:
position: Position, Position2D or Object
radius: Number
Return Value:
Array

Alternative Syntax

Syntax:
position nearObjects [typeName, radius]
Parameters:
position: Array format PositionAGL, Position2D or Object
typeName: String
radius: Number
Return Value:
Array

Examples

Example 1:
_list = position player nearObjects 50;
Example 2:
_list = [_xpos,_ypos] nearObjects ["House", 20];
Example 3:
_list = player nearObjects 20;

Additional Information

See also:
findNearestEnemy nearestBuilding nearestObject nearestObjects nearestLocation nearEntities nearTargets nearSupplies nearestLocationWithDubbing nearObjectsReady nearRoads nearestMines

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Kronzky - c
Posted on Jun 30, 2007 - 08:21 (UTC)
Units in vehicles are not detected via this command.
Tankbuster - c
Posted on Dec 15, 2011 - 23:17 (UTC)
In the second syntax, you can't omit the typeName parameter. It's required and you'll get an error if you don't supply it. Use "All" as an alternative to leaving it out. (CO 1.59)
Tankbuster - c
Posted on Jan 03, 2013 - 19:59 (UTC)
If you use the first syntax, it will return objects many more objects such as pollen, honeybees and crucially, triggers. Triggers will show in the returned array as "no shape" but you can use typeOf to get the classname, which will give "EmptyDetector". This will not return objects that don't have classnames such as plants, stones and some map objects like vehicle wrecks. nearestObjects will find objects without classnames.
Cheitan - c
Posted on Aug 08, 2017 - 16:08 (UTC)
The syntax 2 means that the command will include all types which inherit from the given type. As an example, when using "Helipad_Base_F", the command will detect all types of helipads (Land_HelipadSquare_F, Land_HelipadCircle_F, Land_HelipadEmpty_F, etc) in the given radius.
Retrieved from "https://community.bistudio.com/wiki?title=nearObjects&oldid=330405"