---
name: "BIS_fnc_findOverwatch"
type: function
status: ok
groups: ["Positions"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_findOverwatch
revid: 327931
updated: 2022-07-13T12:32:03Z
---

# BIS_fnc_findOverwatch

*Function · Positions · Arma 3 v1.00*

## Description

Selects a position that provides overwatch onto another position.

## Syntax

```sqf
[target, maxDistance, minDistance, minHeightAbove, searchCentre] call BIS_fnc_findOverwatch
```

**Parameters:**

- `target`: [Position3D](../topics/Position.md#introduction) - **not** an object
- `maxDistance`: [Number](../topics/Number.md) - (Optional, default 500) maximum distance from target in meters
- `minDistance`: [Number](../topics/Number.md) - (Optional, default 100) minimum distance from target in meters
- `minHeightAbove`: [Number](../topics/Number.md) - (Optional, default 50) minimum height in relation to target in meters
- `searchCentre`: [Position3D](../topics/Position.md#introduction) - (Optional, default *target*) position to start looking from, if different from target pos

**Returns:** [Position](../topics/Position.md) - *target* position if no result were found

## Examples

### Example 1

```sqf
[getPosATL enemyTank, 300, 75, 20, getPosATL player] call BIS_fnc_findOverwatch;
```

## See also

[BIS_fnc_findSafePos](../functions/BIS_fnc_findSafePos.md)

## Community notes

**Tankbuster** — 2018-10-19

Note that this function returns a 2D position, that is, an array containing an x and a y value, but no z (no altitude).

---

**Tankbuster** — 2020-04-15

Further note that when this function fails to find an overwatch position and returns the *target*, the x and y components will be exactly the same, but the z might not be.

<sub>Source: [BI Community Wiki — BIS fnc findOverwatch](https://community.bistudio.com/wiki/BIS_fnc_findOverwatch) (revision 327931).</sub>