---
name: "getResolution"
type: command
status: ok
groups: ["System", "GUI Control - Positioning"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getResolution
revid: 378509
updated: 2026-05-03T17:11:30Z
---

# getResolution

*Command · System, GUI Control - Positioning · Arma 3 v0.50 · introduced in Arma 2: Operation Arrowhead v1.55*

## Description

Returns an array containing all information about current client screen resolution.

> [!NOTE]
> **Arma 3:** **Render resolution** is not returned by this command.
>
> A sampling setting of **50%** means half of native width *and* half of native height, resulting in a render resolution of ***25%*** the original resolution.

> [!IMPORTANT]
> The engine default value for `fovTop` is **0.75** in case it is needed to calculate difference with custom FOV.

> [!NOTE]
> The `aspectRatio` is calculated as `fovLeft / fovTop` and should be the same as `screenW / screenH` for undistorted image if the FOV is custom. Some of the common values:
>
> | 16/9 | 16/10 | 5/4 | 4/3 | 16/9 triple screen |
> |---|---|---|---|---|
> | 1.777777(…) | 1.6 | 1.25 | 1.333333(…) | 5.333333(…) |

## Syntax

```sqf
getResolution
```

**Returns:** [Array](../topics/Array.md) with [screenW, screenH, viewPortW, viewPortH, aspectRatio, uiScale, fovTop, fovLeft, tripleHead, textureQuality]
- screenW: [Number](../topics/Number.md) - width of the screen in pixels
- screenH: [Number](../topics/Number.md) - height of the screen in pixels
- viewPortW: [Number](../topics/Number.md) - width of the **4:3** view port in pixels
- viewPortH: [Number](../topics/Number.md) - height of the **4:3** view port in pixels
- aspectRatio: [Number](../topics/Number.md) - screen aspect ratio
- uiScale: [Number](../topics/Number.md) - the scale of the UI, which affects view port size:

|  |  |  |  |  |  |
|---|---|---|---|---|---|
| + Arma 3 | Very Small | Small | Normal | Large | Very Large |
| 0.47 | 0.55 | 0.7 | 0.85 | 1 |  |

- Arma 3 v1.94 fovTop: [Number](../topics/Number.md) - vertical FOV in [rad](../commands/rad.md)ians, the same as `fovTop` value from the user profile
- Arma 3 v1.94 fovLeft: [Number](../topics/Number.md) - horizontal FOV in [rad](../commands/rad.md)ians, the same as`fovLeft` value from the user profile
- Arma 3 v1.94 tripleHead: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if user has triple head screen (see also [safeZoneXAbs](../commands/safeZoneXAbs.md), [safeZoneWAbs](../commands/safeZoneWAbs.md))
- Arma 3 v2.10 textureQuality: [Number](../topics/Number.md) - current texture quality set in user preferences in 0..1 range, where 0 is lowest, 1 is highest

## Examples

### Example 1

```sqf
private _res = getResolution;
```

Example result with a single 16:9 monitor:

```sqf
[
    1920,        // width
    1080,        // height
    792,        // 2D viewport width
    594,        // 2D viewport height
    1.77778,    // aspect ratio
    0.55,        // UI scale
    0.75,        // fovTop
    1.33333,    // fovLeft
    false        // tripleHead
]
```

Example result with a triple 16:9 monitor setup:

```sqf
[
    5760,        // width
    1080,        // height
    792,        // 2D viewport width
    594,        // 2D viewport height
    5.33333,    // aspect ratio
    0.55        // UI scale
]
```

Example result on a dedicated server:

```sqf
[
    160,        // width
    120,        // height
    136,        // 2D viewport width
    102,        // 2D viewport height
    1.33333,    // aspect ratio
    0.85        // UI scale
]
```

## See also

[getObjectFOV](../commands/getObjectFOV.md) · [worldToScreen](../commands/worldToScreen.md) · [screenToWorld](../commands/screenToWorld.md) · [safeZoneX](../commands/safeZoneX.md) · [safeZoneY](../commands/safeZoneY.md) · [safeZoneW](../commands/safeZoneW.md) · [safeZoneH](../commands/safeZoneH.md)

## Community notes

**Tom_48_97** — 2010-12-20

This command can be useful to play a video (see this function [BIS_fnc_playVideo](../functions/BIS_fnc_playVideo.md)) in the given format if you have compiled it for different UI scale.

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