---
name: "checkVisibility"
type: command
status: ok
groups: ["Math - Geometry"]
arma3_since: "1.56"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/checkVisibility
revid: 377827
updated: 2026-01-03T04:27:56Z
---

# checkVisibility

*Command · Math - Geometry · Arma 3 v1.56*

## Description

| Affected by | Not affected by |
|---|---|
| - [terrain grid](../commands/getTerrainGrid.md)<br>- obstacles<br>- particles<br>(with `blockAIVisibility = 1`) | - [daylight](../commands/time.md)<br>- [distance](../commands/distance.md)<br>- [overcast](../commands/overcast.md)<br>- [fog](../commands/fog.md) |

Checks if one position is visible from another position and how much.

> [!NOTE]
> Particles that have `blockAIVisibility` set to 1 will influence the result, but will never make [checkVisibility](../commands/checkVisibility.md) return 0; an extremely small number will be returned instead.

## Syntax

```sqf
[ignore, LOD, ignore2] checkVisibility [beg, end]
```

**Parameters:**

- `ignore`: [Object](../topics/Object.md) - object to exclude from calculations
- `LOD`: [String](../topics/String.md) - level of details to use. Possible values are: `"FIRE"`, `"VIEW"`, `"GEOM"`, `"IFIRE"`, and Arma 3 v2.02 `"PHYSX"`
- `ignore2`: [Object](../topics/Object.md) - (Optional, default [objNull](../commands/objNull.md)) second object to exclude from calculations *(since arma3 1.62)*
- `beg`: [PositionASL](../topics/Position.md#positionasl) - start position
- `end`: [PositionASL](../topics/Position.md#positionasl) - end position

**Returns:** [Number](../topics/Number.md) - how much end position is visible to start position in range 0..1, where 1 is fully visible.

## Examples

### Example 1

```sqf
private _canSee = [objNull, "VIEW"] checkVisibility [eyePos player, eyePos unit1];
```

## See also

[lineIntersectsWith](../commands/lineIntersectsWith.md) · [lineIntersectsSurfaces](../commands/lineIntersectsSurfaces.md) · [lineIntersectsObjs](../commands/lineIntersectsObjs.md) · [intersect](../commands/intersect.md) · [terrainIntersect](../commands/terrainIntersect.md) · [terrainIntersectASL](../commands/terrainIntersectASL.md) · [terrainIntersectAtASL](../commands/terrainIntersectAtASL.md) · [lineIntersects](../commands/lineIntersects.md) · [cursorObject](../commands/cursorObject.md) · [cursorTarget](../commands/cursorTarget.md) · [disableRemoteSensors](../commands/disableRemoteSensors.md)

<sub>Source: [BI Community Wiki — checkVisibility](https://community.bistudio.com/wiki/checkVisibility) (revision 377827).</sub>