---
name: "BIS_fnc_inTrigger"
type: function
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_inTrigger
revid: 369527
updated: 2024-09-15T18:22:20Z
---

# BIS_fnc_inTrigger

*Function · Object Manipulation · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Detects whether position is within area **or** calculates distance to the nearest edge of trigger area by using optional params.

> [!NOTE]
> **Arma 3:** Since Arma 3 v1.58 [inArea](../commands/inArea.md) is available for an area check.

## Syntax

```sqf
[area, position, returnDistance, includeFloorCeiling] call BIS_fnc_inTrigger
```

**Parameters:**

- `area`: [Object](../topics/Object.md), [String](../topics/String.md), [Location](../topics/Location.md) or [Array](../topics/Array.md)
  - [Object](../topics/Object.md) - trigger
  - [String](../topics/String.md) - marker
  - [Location](../topics/Location.md) - location
  - [Array](../topics/Array.md) - in format [center, distance] or [center, [a, b, angle, rect]] or [center, [a, b, angle, rect, height]]
- `position`: [Object](../topics/Object.md) or [Array](../topics/Array.md) - position to check (e.g. [player](../commands/player.md)) or [Position](../topics/Position.md)
- `returnDistance`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) [true](../commands/true.md) to return distance to nearest edge of trigger area
- `includeFloorCeiling`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) to include trigger area floor and ceiling in calculation when calculating distance to nearest edge

**Returns:** - [Boolean](../topics/Boolean.md) - [true](../commands/true.md) when position is in area, false if not
- [Number](../topics/Number.md) - (when *returnDistance* is [true](../commands/true.md)) - distance from closest border: negative distance - from inside, positive distance - from outside

## Examples

### Example 1

```sqf
private _trigger = createTrigger ["EmptyDetector", getPosATL player];
_trigger setTriggerArea [10, 10, 0, false];
_inTrigger = [_trigger, player] call BIS_fnc_inTrigger; // _inTrigger = true
```

## See also

[createTrigger](../commands/createTrigger.md) · [createMarker](../commands/createMarker.md) · [setTriggerArea](../commands/setTriggerArea.md) · [setMarkerSize](../commands/setMarkerSize.md) · [triggerArea](../commands/triggerArea.md) · [markerSize](../commands/markerSize.md) · [inArea](../commands/inArea.md) · [inAreaArray](../commands/inAreaArray.md) · [BIS_fnc_getArea](../functions/BIS_fnc_getArea.md)

<sub>Source: [BI Community Wiki — BIS fnc inTrigger](https://community.bistudio.com/wiki/BIS_fnc_inTrigger) (revision 369527).</sub>