nearestLocations: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(add. ArmA2 classification)
m (Some wiki formatting)
 
(74 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.08


|1.08|= Game version
|game2= arma2
|version2= 1.00


|arg= |= Arguments in MP
|game3= arma2oa
|version3= 1.50


|eff= |= Effects in MP
|game4= tkoh
____________________________________________________________________________________________
|version4= 1.00


| Returns an array of locations of chosen type(s) within the given radius of the given position, sorted from nearest to farthest. |= Description
|game5= arma3
____________________________________________________________________________________________
|version5= 0.50


| [[Array]] <nowiki>=</nowiki> '''nearestLocations''' [position, [locationType,...], radius] |= Syntax
|gr1= Locations


|p1= [position, [locationType,...], radius]: [[Array]] |= Parameter 1
|descr= Returns an array of locations of chosen type(s) within the given radius of the given position, sorted from nearest to farthest.
|p2= position: [[Array]] - format [[Position]] |= Parameter 2
{{Feature|informative|Although locations can be placed in 3D with [[setPosition]], [[nearestLocations]]' search result is sorted in 2D.}}
|p3= [locationType,...]: [[Array]] An array of location type name [[String|strings]] |= Parameter 3
|p4= radius: [[Number]] The maximum distance from the given position that returned locations may be, in meters. |= Parameter 4


|s1= [[nearestLocations]] [centre, locationTypes, radius, sortPosition]


| [[Array]] of [[Location|locations]] |= Return value
|p1= centre: [[Array]] format [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] or [[Object]]
____________________________________________________________________________________________
 
|x1= <pre>_nearbyLocations = nearestLocations [getPos player, ["RockArea","VegetationFir"], 100]</pre> |= Example 1
____________________________________________________________________________________________


| [[nearestLocation]] |= See also
|p2= locationTypes: [[Array]] of [[String]]s - list of [[Location#Location Types|location type]] names, e.g "NameCity"; {{GVI|arma3|2.14|size= 0.75}} passing empty array [] will return all available locations within the radius


}}
|p3= radius: [[Number]] - maximum distance from the given position that returned locations may be, in metres


<h3 style="display:none">Notes</h3>
|p4= sortPosition: [[Array]] format [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] or [[Object]] - (Optional) results will be sorted from the distance to given ''sortPosition'' (nearest to farthest still)
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r1= [[Array]] of [[Location]]s
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>_nearbyLocations = nearestLocations [getPosATL player, ["RockArea", "VegetationFir"], 100];</sqf>


|x2= Find any of nearest locations:
<sqf>
private _allLocationTypes = [];
"_allLocationTypes pushBack configName _x" configClasses (configFile >> "CfgLocationTypes");
{
systemChat format [
"%1 (%2) - %3m",
_x,
text _x,
getPosATL player distance _x
];
} forEach nearestLocations [player, _allLocationTypes, 500];
</sqf>


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|seealso= [[createLocation]] [[nearestLocation]] [[locationPosition]] [[nearestLocationWithDubbing]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Command_Group:_Locations|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]

Latest revision as of 02:20, 6 September 2023

Logo A1 black.png1.08Logo 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:
Returns an array of locations of chosen type(s) within the given radius of the given position, sorted from nearest to farthest.
ⓘ
Although locations can be placed in 3D with setPosition, nearestLocations' search result is sorted in 2D.
Groups:
Locations

Syntax

Syntax:
nearestLocations [centre, locationTypes, radius, sortPosition]
Parameters:
centre: Array format Position2D, Position3D or Object
locationTypes: Array of Strings - list of location type names, e.g "NameCity"; Arma 3 logo black.png2.14 passing empty array [] will return all available locations within the radius
radius: Number - maximum distance from the given position that returned locations may be, in metres
sortPosition: Array format Position2D, Position3D or Object - (Optional) results will be sorted from the distance to given sortPosition (nearest to farthest still)
Return Value:
Array of Locations

Examples

Example 1:
_nearbyLocations = nearestLocations [getPosATL player, ["RockArea", "VegetationFir"], 100];
Example 2:
Find any of nearest locations:
private _allLocationTypes = []; "_allLocationTypes pushBack configName _x" configClasses (configFile >> "CfgLocationTypes"); { systemChat format [ "%1 (%2) - %3m", _x, text _x, getPosATL player distance _x ]; } forEach nearestLocations [player, _allLocationTypes, 500];

Additional Information

See also:
createLocation nearestLocation locationPosition nearestLocationWithDubbing

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
Retrieved from "https://community.bistudio.com/wiki?title=nearestLocations&oldid=347242"