# getWorldFromScreenPosition (Cliente)

> Converte um ponto da tela, a uma profundidade, num ponto do mundo, com a câmera do quadro atual.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Mundo e clima
- **URL**: https://wiki.mymp.gg/pt/getWorldFromScreenPosition

## Sintaxe

```lua
vec3 getWorldFromScreenPosition(float x, y, depth)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, depth` | `float` | As coordenadas da tela em pixels e a distância à câmera ao longo da direção em que ela olha, em metros. Também aceita um `vec3`. |

## Retorno

O ponto no mundo.

## Exemplo

```lua
local sx, sy = getScreenSize()
local ahead = getWorldFromScreenPosition(sx / 2, sy / 2, 50)
outputDebugString(("50 m ahead: %.1f, %.1f, %.1f"):format(ahead.x, ahead.y, ahead.z))
```

## Veja também

- [getScreenFromWorldPosition (Cliente)](https://wiki.mymp.gg/pt/getScreenFromWorldPosition.md): Projeta um ponto do mundo na tela, com a câmera do quadro atual.
- [getCursorPosition (Cliente)](https://wiki.mymp.gg/pt/getCursorPosition.md): Lê onde o cursor está na tela e o ponto do mundo para onde ele aponta.
- [processLineOfSight (Cliente)](https://wiki.mymp.gg/pt/processLineOfSight.md): Lança um raio entre dois pontos e devolve a primeira coisa que ele acerta.
