BIS fnc randomPos: Difference between revisions

Revision as of 14:18, 25 February 2021

Game1 needed - Version1 needed

1.00

Hover & click on the images for description

Description

Description:: This article is a Stub. You can help BI Community Wiki by expanding it.
Description needed
Execution:: call
Groups:: Map and Markers

Syntax

Syntax:

Syntax needed

Parameters:

[whitelist, blacklist, code]: Array

whitelist (Optional): Array - whitelisted areas. If not given, whole map is used. Areas could be:

Object - trigger
String - marker
Array - in format [center, radius] or [center, [a, b, angle, rect]]
Location - location.

blacklist (Optional): Array - blacklisted areas. If not given, water is blacklisted. Areas could be:

Object - trigger
String - marker name or special tags names: "water" - exclude water, "ground" - exclude land
Array - in format [center, radius] or [center, [a, b, angle, rect]]
Location - location.

code (Optional): Code - custom condition which should return true for current position candidate passed in _this variable to be accepted. If not specified all candidates are accepted

Return Value:

Return value needed

Examples

Example 1:: _randomPosMapNoWater = [] call BIS_fnc_randomPos;
Example 2:: _randomPosMapNoWater = [nil, ["water"]] call BIS_fnc_randomPos;
Example 3:: _randomPosMapNoLand = [nil, ["ground"]] call BIS_fnc_randomPos;
Example 4:: _randomPosMap = [nil, []] call BIS_fnc_randomPos;
Example 5:: _randomPosAroundPlayer = [[[position player, 50]],[]] call BIS_fnc_randomPos;

Additional Information

See also:: BIS_fnc_randomPosTrigger BIS_fnc_getArea BIS_fnc_findSafePos

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

Posted on March 30, 2020 - 21:33 (UTC)
Tankbuster: The code parameter here can be quite powerful. If using example 5 above, adding code as below will make the returned positions always be on a road. randomRoadPosAroundPlayer = [[[position player,50]],[], {isOnRoad _this}] call BIS_fnc_randomPos;

@@ Line 23: / Line 23: @@
 * [[Array]] - in format [center, radius] or [center, [a, b, angle, rect]]
 * [[Location]] - location.
-|p4= code (Optional): [[Code]] - custom condition which should return true for current position candidate passed in [[_this]] variable to be accepted. If not specified all candidates are accepted
+|p4= code (Optional): [[Code]] - custom condition which should return true for current position candidate passed in [[Magic Variables#this|_this]] variable to be accepted. If not specified all candidates are accepted
 |[[Array]] - position candidate in format [x,y,z] or [0,0] if position cannot be found