# getScreenFromWorldPosition (Cliente)

> Proyecta un punto del mundo en la pantalla, con la cámara del fotograma actual.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Mundo y clima
- **URL**: https://wiki.mymp.gg/es/getScreenFromWorldPosition

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y, z` | `float` | El punto en el mundo. También acepta un `vec3`. |
| `edgeTolerance` | `float` | Cuánto puede quedar el punto fuera de la pantalla y aun así devolverse. *(por defecto: `0`)* |
| `relative` | `bool` | Si es `true`, la tolerancia es una fracción del ancho y el alto de la pantalla; si es `false`, va en píxeles. *(por defecto: `true`)* |

## Retorno

Las coordenadas `x, y` en píxeles y la distancia del punto a la cámara a lo largo de su dirección de vista. `false` si el punto está detrás de la cámara o fuera de la pantalla más allá de la tolerancia.

## Ejemplo

```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)
```

## Ver también

- [getWorldFromScreenPosition (Cliente)](https://wiki.mymp.gg/es/getWorldFromScreenPosition.md): Convierte un punto de la pantalla, a una profundidad, en un punto del mundo, con la cámara del fotograma actual.
- [getScreenSize (Cliente)](https://wiki.mymp.gg/es/getScreenSize.md): Devuelve el tamaño de la pantalla del juego en píxeles.
- [dxDrawText (Cliente)](https://wiki.mymp.gg/es/dxDrawText.md): Dibuja un texto en la pantalla durante un fotograma, dentro de una caja.