# getScreenFromWorldPosition (Cliente)

> Projeta um ponto do mundo na tela, 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/getScreenFromWorldPosition

## Sintaxe

```lua
float, float, float|false getScreenFromWorldPosition(float x, y, z [, float edgeTolerance = 0, bool relative = true])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | O ponto no mundo. Também aceita um `vec3`. |
| `edgeTolerance` | `float` | Quanto o ponto pode ficar fora da tela e ainda ser devolvido. *(padrão: `0`)* |
| `relative` | `bool` | Se `true`, a tolerância é uma fração da largura e da altura da tela; se `false`, é em pixels. *(padrão: `true`)* |

## Retorno

As coordenadas `x, y` em pixels e a distância do ponto à câmera ao longo da direção em que ela olha. `false` se o ponto está atrás da câmera ou fora da tela além da tolerância.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    local pos = getElementPosition(localPlayer)
    local sx, sy = getScreenFromWorldPosition(pos.x, pos.y, pos.z + 1.2)
    if sx then
        dxDrawText("Me", sx, sy)
    end
end)
```

## Veja também

- [getWorldFromScreenPosition (Cliente)](https://wiki.mymp.gg/pt/getWorldFromScreenPosition.md): Converte um ponto da tela, a uma profundidade, num ponto do mundo, com a câmera do quadro atual.
- [getScreenSize (Cliente)](https://wiki.mymp.gg/pt/getScreenSize.md): Devolve o tamanho da tela do jogo em pixels.
- [dxDrawText (Cliente)](https://wiki.mymp.gg/pt/dxDrawText.md): Desenha um texto na tela durante um quadro, dentro de uma caixa.