---
name: "BIS_fnc_HUDLimits"
type: function
status: ok
groups: ["GUI"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_HUDLimits
revid: 327970
updated: 2022-07-13T14:25:56Z
---

# BIS_fnc_HUDLimits

*Function · GUI · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

## Description

Set helicopter advanced flight model HUD limits and prevents overwriting existing values. See also [setHUDMovementLevels](../commands/setHUDMovementLevels.md).

> [!NOTE]
> - default value is 0, which means no limits were assigned
> - using 0 in min or max value will hide the corresponding limit
> - same or higher priority will replace currently set priority
> - using a negative priority will reset the values if absolute value is same or higher than current level

## Syntax

```sqf
[speedLimit, altLimit, dirLimit] call BIS_fnc_HUDLimits
```

**Parameters:**

- `speedLimit`: [Array](../topics/Array.md) in format [priority, min, max]:
  - priority: [Number](../topics/Number.md)
  - min: [Number](../topics/Number.md)
  - max: [Number](../topics/Number.md)
- `altLimit`: [Array](../topics/Array.md) in format [priority, min, max]:
  - priority: [Number](../topics/Number.md)
  - min: [Number](../topics/Number.md)
  - max: [Number](../topics/Number.md)
- `dirLimit`: [Array](../topics/Array.md) in format [priority, min, max, target]:
  - priority: [Number](../topics/Number.md)
  - min: [Number](../topics/Number.md) - you can set a "negative" value by adding 360 (e.g using 270 instead of -90)
  - max: [Number](../topics/Number.md)
  - target: [Position](../topics/Position.md) or [Object](../topics/Object.md) - (Optional, default [0,0,0]) the direction relative target

**Returns:** [Array](../topics/Array.md) - current value of [HUDMovementLevels](../commands/HUDMovementLevels.md)

## Examples

### Example 1

```sqf
[[0,0,0], [1, 0, 50], [0,0,0]] call BIS_fnc_HUDLimits; // limits altitude on HUD to 50m max
```

### Example 2

```sqf
[[0,0,0], [0, 0, 0], [1,330,30, myTarget]] call BIS_fnc_HUDLimits; // limits orientation towards myTarget by ±30°
```

## See also

[HUDMovementLevels](../commands/HUDMovementLevels.md) · [setHUDMovementLevels](../commands/setHUDMovementLevels.md)

<sub>Source: [BI Community Wiki — BIS fnc HUDLimits](https://community.bistudio.com/wiki/BIS_fnc_HUDLimits) (revision 327970).</sub>