nearestLocations: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(example)
(description)
Line 16: Line 16:
| '''nearestLocations''' [position, [locationType,...], radius, sortPosition] |= Syntax
| '''nearestLocations''' [position, [locationType,...], radius, sortPosition] |= Syntax


|p1= [position, [locationType,...], radius, sortFrom]: [[Array]] |= Parameter 1
|p1= [position, [locationType,...], radius, sortPosition]: [[Array]] |= Parameter 1
|p2= position: [[Array]] - [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 2
|p2= position: [[Array]] - [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 2
|p3= [locationType,...]: [[Array]] |= Parameter 3
|p3= [locationType,...]: [[Array]] |= Parameter 3
|p4= locationType: [[String]] - location type name, e.g "NameCity"
|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.
|p5= radius: [[Number]] - maximum distance from the given position that returned locations may be, in meters.
|p6= sortPosition (Optional): [[Array]] - [[Position2D]], [[Position3D]] or [[Object]] |= Parameter 4
|p6= sortPosition (Optional): [[Array]] - [[Position2D]], [[Position3D]] or [[Object]] - results will be sorted: nearest location to given ''sortPosition'' first|= Parameter 4





Revision as of 22:35, 1 September 2016

-wrong parameter ("Arma") defined!-1.08
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.
Groups:
Uncategorised

Syntax

Syntax:
nearestLocations [position, [locationType,...], radius, sortPosition]
Parameters:
[position, [locationType,...], radius, sortPosition]: Array
position: Array - Position2D, Position3D or Object
[locationType,...]: Array
locationType: String - location type name, e.g "NameCity"
radius: Number - maximum distance from the given position that returned locations may be, in meters.
sortPosition (Optional): Array - Position2D, Position3D or Object - results will be sorted: nearest location to given sortPosition first
Return Value:
Array of locations

Examples

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

Additional Information

See also:
createLocationnearestLocationlocationPositionnearestLocationWithDubbing

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

Notes

Bottom Section