getResolution

Arma 3 v0.50
First in Arma 2: Operation Arrowhead v1.55

Command · also in GUI Control - Positioning · Markdown · JSON · original wiki page

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(…)

16/9	16/10	5/4	4/3	16/9 triple screen
1.777777(…)	1.6	1.25	1.333333(…)	5.333333(…)

Syntax

getResolution

Returns: Array with [screenW, screenH, viewPortW, viewPortH, aspectRatio, uiScale, fovTop, fovLeft, tripleHead, textureQuality]

screenW: Number - width of the screen in pixels
screenH: Number - height of the screen in pixels
viewPortW: Number - width of the 4:3 view port in pixels
viewPortH: Number - height of the 4:3 view port in pixels
aspectRatio: Number - screen aspect ratio
uiScale: Number - 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 - vertical FOV in radians, the same as fovTop value from the user profile
Arma 3 v1.94 fovLeft: Number - horizontal FOV in radians, the same asfovLeft value from the user profile
Arma 3 v1.94 tripleHead: Boolean - true if user has triple head screen (see also safeZoneXAbs, safeZoneWAbs)
Arma 3 v2.10 textureQuality: Number - current texture quality set in user preferences in 0..1 range, where 0 is lowest, 1 is highest

Examples

Example 1

private _res = getResolution;

Example result with a single 16:9 monitor:

[
    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:

[
    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:

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

Community notes

Tom_48_97

2010-12-20

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