screenToWorld

1.001.501.000.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 screenToWorldVector vector up to viewDistance for terrain intersection and 2 * viewDistance for water intersection. In other words, it's similar to doing:

private _p1 = AGLtoASL positionCameraToWorld [0,0,0]; // camera position ASL private _vector = screenToWorldVector _screenPos; // "aim" vector private _p2 = _p1 vectorAdd (_vector vectorMultiply viewDistance * 2); // the ray doesn't go beyond 2 * view distance ASLtoAGL terrainIntersectAtASL [_p1, _p2]

Groups:

Positions

Syntax

Syntax:

screenToWorld screen

Parameters:

screen: Array - screen position [x,y] (see SafeZone for more info)

Return Value:

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

Alternative Syntax

Syntax:

camera screenToWorld position

Parameters:

camera: Object - camera object

position: Array - screen position [x,y] (see SafeZone for more info)

Return Value:

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

Examples

Example 1:

_wPos = screenToWorld [0.5, 0.5];

Additional Information

See also:

SafeZone worldToScreen screenToWorldVector

Notes

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