screenToWorld

1.00 1.50 1.00 0.50

Hover & click on the images for description

Description

Description:

Returns the position on landscape (PositionAGL) corresponding to the given point on screen (in UI coordinates).

ⓘ

This command performs an intersection with the ground/water surface, from the camera position along the screenToWorldDirection vector up to viewDistance for terrain intersection and 2 * viewDistance for water intersection. In other words, it is similar to doing:

private _p1 = AGLToASL positionCameraToWorld [0, 0, 0]; // camera position ASL private _vector = screenToWorldDirection _screenPos; // "aim" vector private _p2 = _p1 vectorAdd (_vector vectorMultiply viewDistance * 2); // the ray does not go beyond 2 * view distance ASLToAGL terrainIntersectAtASL [_p1, _p2]

Groups:

Positions

Syntax

Syntax:

screenToWorld screen

Parameters:

screen: Array with [x, y] - screen position, see SafeZone for more information

• x: Number
• y: Number

Return Value:

PositionAGL, world position on surface [x, y, 0]

2.18

Alternative Syntax

Syntax:

camera screenToWorld position

Parameters:

camera: Object - camera object

screen: Array with [x, y] - screen position, see SafeZone for more information

• x: Number
• y: Number

Return Value:

PositionAGL, world position on surface [x,y,0]

Examples

Example 1:

private _wPos = screenToWorld [0.5, 0.5];

Example 2:

private _wPos = _myCamera screenToWorld [0.5, 0.5]; // since Arma 3 2.18

Additional Information

See also:

SafeZone worldToScreen screenToWorldDirection

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note