findEmptyPosition

From Bohemia Interactive Community
Jump to: navigation, search
Introduced with Arma 2 version 1.00
  

Click on the images for descriptions

Introduced in

Game:
Arma 2
Version:
1.00

Description

Description:
Searches for an empty position around specified position. The search starts looking for an empty position at a minimum distance of [minDistance] from the [center] and looks as far away as [maxDistance]. If a [vehicleType] parameter is specified, then the search will look for an empty positions that is big enough to hold that vehicle type. If an empty position isn't found, an empty array is returned.

This command ignores moving objects present within search area.

Syntax

Syntax:
center findEmptyPosition [minDistance, maxDistance, vehicleType]
Parameters:
center: Array - Search area center position in format [x,y] or [x,y,z] in which case z is ignored. Accepts Position2D or Position3D
[minDistance, maxDistance, vehicleType]: Array
minDistance: Number - Start searching no closer than minDistance from the center
maxDistance: Number - Stop searching no further than maxDistance from the center
vehicleType: (optional): String - Class name of a vehicle to accommodate
Return Value:
Array - A suitable empty position in format Position3D or [] if not found

Examples

Example 1:
_position = (getPosATL player) findEmptyPosition [0,100];
Example 2:
_position = _center findEmptyPosition [10,100,"UH60M_EP1"];
Example 3:
Check if exact position is empty: _position = _center findEmptyPosition [0,0,"B_Boat_Armed_01_minigun_F"];

Additional Information

Multiplayer:
-
See also:
findEmptyPositionReadyselectBestPlacesisFlatEmpty

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Posted on November 6, 2013
Killzone_Kid
Keep search radius short and sweet, under 50 metres maybe. Searching big area takes long time and will result in your game stop responding until the search is over. isFlatEmpty is probably more suitable for a larger area search.
Posted on March 6, 2012
old_man_auz
I think the radius parameter should be treated as a 'minimum distance' from the centre position. I found that the parameter name radius wasn't very clear. Also, if radius is greater than max distance then the function will always return an empty array. Here is an snippet of code I use to find a safe landing zone for an extraction helicopter. It may be useful for someone. _centre = [ getMarkerPos "marker" , random 150 , random 360 ] call BIS_fnc_relPos; _extraction_point = []; _max_distance = 100; while{ count _extraction_point < 1 } do { _extraction_point = _centre findEmptyPosition[ 30 , _max_distance , "UH60M_EP1" ]; _max_distance = _max_distance + 50; }; In the above example, make sure that "_max_distance" is greater than 30, otherwise the while loop will go forever.

Bottom Section