getResolution

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

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 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
]

See also

getObjectFOV · worldToScreen · screenToWorld · safeZoneX · safeZoneY · safeZoneW · safeZoneH