nearestLocations: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Some wiki formatting)
 
(63 intermediate revisions by 7 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


| '''nearestLocations''' [position, [locationType,...], radius, sortPosition] |SYNTAX=
|gr1= Locations


|p1= [position, [locationType,...], radius, sortPosition]: [[Array]] |PARAMETER1=
|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]] - [[Position2D]], [[Position3D]] or [[Object]] |PARAMETER2=
{{Feature|informative|Although locations can be placed in 3D with [[setPosition]], [[nearestLocations]]' search result is sorted in 2D.}}
|p3= [locationType,...]: [[Array]] |PARAMETER3=
|p4= locationType: [[String]] - location type name, e.g "NameCity"
|p5= radius: [[Number]] - maximum distance from the given position that returned locations may be, in meters.
|p6= sortPosition (Optional): [[Array]] - [[Position2D]], [[Position3D]] or [[Object]] - results will be sorted: nearest location to given ''sortPosition'' first|PARAMETER4=


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


| [[Array]] of [[Location|locations]] |RETURNVALUE=
|p1= centre: [[Array]] format [[Position#Introduction|Position2D]], [[Position#Introduction|Position3D]] or [[Object]]
____________________________________________________________________________________________
 
|x1= <code>_nearbyLocations = [[nearestLocations]] <nowiki>[</nowiki>[[position]] [[player]], ["RockArea","VegetationFir"], 100];</code> |EXAMPLE1=


|x2= Find any of nearest locations:<code>allLocationTypes = [];
|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
"allLocationTypes [[pushBack]] [[configName]] _x" [[configClasses]] (
 
[[configFile]] >> "CfgLocationTypes"
|p3= radius: [[Number]] - maximum distance from the given position that returned locations may be, in metres
);
 
|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)
 
|r1= [[Array]] of [[Location]]s
 
|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]] [
systemChat format [
"%1 (%2) - %3m",  
"%1 (%2) - %3m",  
_x,  
_x,  
[[text]] _x,  
text _x,  
[[position]] [[player]] [[distance]] _x
getPosATL player distance _x
];
];
} [[forEach]] [[nearestLocations]] <nowiki>[</nowiki>[[player]], allLocationTypes, 500];</code> |=
} forEach nearestLocations [player, _allLocationTypes, 500];
____________________________________________________________________________________________
</sqf>
 
| [[createLocation]], [[nearestLocation]], [[locationPosition]], [[nearestLocationWithDubbing]] |SEEALSO=


|seealso= [[createLocation]] [[nearestLocation]] [[locationPosition]] [[nearestLocationWithDubbing]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Locations|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{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"